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Chapter  1 

INTRODUCTION  TO  ASSEMBLY 
LANGUAGE  PHOGRAMMING 


This  book  describes  assembly  language  programming.  It  assumes  that  you  are 
familiar  with  An  Introduction  To  Microcomputers:  Volume  1  — Basic  Concepts 
{particularly  Chapters  6  and  7).  This  book  does  not  discuss  the  general  features  of 
computers,  microcomputers,  addressing  methods,  or  instruction  sets;  you  should 
refer  to  An  Introduction  To  Microcomputers:  Volume  1  for  that  information. 

HOW  THIS  BOOK  HAS  BEEN  PRINTED 

Notice  that  text  in  this  book  has  been  printed  in  boldface  type  and  lightface  type. 
This  has  been  done  to  help  you  skip  those  parts  of  the  book  that  cover  subject 
matter  with  which  you  are  familiar.  You  can  be  sure  that  lightface  type  only  ex- 
pands on  information  presented  in  the  previous  boldface  type.  Therefore,  onlv  read 
boldface  type  until  vou  reach  a  subject  about  which  you  want  to  know  more,  at  which 
point  start  reading  the  lightface  type. 


THE  MEANING  OF  INSTRUCTIONS 

The  instruction  set  of  a  microprocessor  is  the  set  of  binary  inputs  which  produce 
defined  actions  during  an  instruction  cycle.  An  instruction  set  is  to  a  microprocessor 
what  a  function  table  is  to  a  logic  device  such  as  a  gate,  adder,  or  shift  register.  Of 
course,  the  actions  that  the  microprocessor  performs  in  response  to  the  instruction  in- 
puts are  far  more  complex  than  the  actions  that  combinatorial  logic  devices  perform  in 
response  to  their  inputs. 


BINARY 
INSTRUCTIONS 


An  instruction  is  simply  a  binary  bit  pattern  —  it  must  be 
available  at  the  data  inputs  to  the  microprocessor  at  the 
proper  time  in  order  to  be  interpreted  as  an  instruction.  For  ex- 
ample, when  the  Z80  microprocessor  receives  the  8-bit  binary  pattern  1 0000000  as  the 
input  during  an  instruction  fetch  operation,  the  pattern  means: 

"Add  the  contents  of  Register  B  to  the  contents  of  the  Accumulator". 

Similarly,  the  pattern  001 11110  means: 

"Load  the  Accumulator  with  the  contents  of  the  next  word  of  program  memory". 

The  microprocessor  (like  any  other  computer)  recognizes  only  binary  patterns  as  in- 
structions or  data;  it  does  not  recognize  words  or  octal,  decimal,  or  hexadecimal  num- 
bers. 

A  COMPUTER  PROGRAM 

A  program  is  a  series  of  instructions  that  cause  a  computer  to  perform  a  particular 
task. 


Actually,  a  computer  program  includes  more  than  instructions;  it 
also  contains  the  data  and  memory  addresses  that  the 
microprocessor  needs  to  accomplish  the  task  defined  by  the  in- 
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structlons.  Clearly,  if  the  microprocessor  is  to  perform  an  addition,  it  must  have  two 
numbers  to  add  and  a  destination  for  the  result.  The  computer  program  must  determine 
the  sources  of  the  data  and  the  destination  of  the  result  as  well  as  specifying  the  opera- 
tion to  be  performed. 

All  microprocessors  execute  instructions  sequentially  unless  one  of  the  instructions 
changes  the  execution  sequence  or  halts  the  computer  (i.e..  the  processor  gets  the  next 
instruction  from  the  next  consecutive  memory  address  unless  the  current  instruction 
specifically  directs  it  to  do  otherwise). 

Ultimately  every  program  becomes  translated  into  a  set  of  binary  numbers.  For 
example,  this  is  the  Z80  program  that  adds  the  contents  of  memory  locations 
60tg  and  61  tg  and  places  the  result  in  memory  location  62iq: 

00111010 
01100000 
00000000 
01000111 
00111010 
01100001 
00000000 
10000000 
00110010 
01100010 
00000000 

This  is  a  machine  language,  or  object,  program.  If  this  program 
were  entered  into  the  memory  of  a  Z80-based  microcomputer,  the 
microcomputer  would  be  able  to  execute  it  directly. 

THE  PROGRAMMING  PROBLEM 

There  are  many  difficulties  associated  with  creating  programs 
as  object,  or  binary  machine  language,  programs.  These  are 
some  of  the  problems: 

1)  The  programs  are  difficult  to  understand  or  debug  (binary  numbers  all  look  the 
same,  particularly  after  you  have  looked  at  them  for  a  few  hours). 

2)  The  programs  are  slow  to  enter  since  you  must  enter  each  bit  individually. 

3)  The  programs  do  not  describe  the  task  which  you  want  the  computer  to  perform  in 
anything  resembling  a  human  readable  format. 

4)  The  programs  are  long  and  tiresome  to  write. 

5)  The  programmer  often  makes  careless  errors  that  are  very  difficult  to  find. 

For  example,  the  following  version  of  the  addition  object  program  contains  a  single 
bit  error.  Try  to  find  it; 

00111010 
01100000 
00000000 
01000111 
01110010 
01100001 
00000000 
10000000 
00110010 
01100010 
00000000 
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Although  the  computer  handles  binary  numbers  with  ease,  people  do  not.  People  find 
binary  programs  long,  tiresome,  confusing,  and  meaningless.  Eventually,  a  programmer 
may  start  remembering  some  of  the  binary  codes,  but  such  effort  should  be  spent  more 
productively. 

USING  OCTAL  OR  HEXADECIMAL 


OCTAL  OR 
HEXADECIMAL 


We  can  improve  the  situation  somewhat  by  writing  instruc- 
tions using  octal  or  hexadecimal,  rather  than  binary,  numbers. 

We  will  use  hexadecimal  numbers  in  this  book  because  they  are 
shorter,  and  because  they  are  the  standard  for  the  microprocessor  industry.  Table  1-1 
defines  the  hexadecimal  digits  and  their  binary  equivalents.  The  Z80  program  to  add 
two  numbers  now  becomes: 

3A 
60 
00 
47 
3A 
61 
00 
80 
32 
62 
00 

At  the  very  least,  the  hexadecimal  version  is  shorter  to  write  and  not  quite  so  tiring  to 
examine. 

Errors  are  somewhat  easier  to  find  in  a  sequence  of  hexadecimal  digits.  The  er- 
roneous version  of  the  addition  program,  in  hexadecimal  form,  becomes: 

3A 
60 
00 
47 
72 
61 
00 
80 
32 
62 
00 

The  mistake  is  easier  to  spot. 

What  do  we  do  with  this  hexadecimal  program?  The  microprocessor  understands 
only  binary  instruction  codes.  The  answer  is  that  we  must  convert  the  hexadecimal 
numbers  to  binary  numbers.  This  conversion  is  a  repetitive,  tiresome  task.  People  who 
attempt  it  make  all  sorts  of  petty  mistakes,  such  as  looking  at  the  wrong  line,  dropping  a 
bit,  or  transposing  a  bit  or  a  digit. 

This  repetitive,  grueling  task  is,  however,  a  perfect  job  for  a  com- 
puter. The  computer  never  gets  tired  or  bored  and  never  makes 
silly  mistakes.  The  idea  then  is  to  write  a  program  which  takes 
hexadecimal  numbers  and  converts  them  into  binary  numbers.  This  is  a  standard 
program  provided  with  many  microprocessors;  it  is  called  a  "hexadecimal  loader." 

Is  a  hexadecimal  loader  worth  having?  If  you  are  willing  to  write  a  program  using  binary 
numbers,  and  you  are  prepared  to  enter  the  program  in  its  binary  form  into  the  com- 
puter, then  you  will  not  need  the  hexadecimal  loader. 
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If  you  choose  the  hexadecimal  loader,  you  will  have  to  pay  a  price  for  it.  The  hex- 
adecimal loader  is  itself  a  program  which  you  must  load  into  memory.  Furthermore,  the 
hexadecimal  loader  will  occupy  memory  —  memory  that  you  may  want  to  use  in  some 
other  way. 

The  basic  tradeoff,  therefore,  is  the  cost  and  memory  requirements  of  the  hexadecimal 
loader  versus  the  savings  in  programmer  time. 

-A  hexadecimal  loader  is  well  worth  its  small  cost. 

A  hexadecimal  loader  certainly  does  not  solve  every  programming  problem.  The  hex- 
adecimal version  of  the  program  is  still  difficult  to  read  or  understand;  for  example,  it 
does  not  distinguish  instructions  from  data  or  addresses,  nor  does  the  program  listing 
provide  any  suggestion  as  to  what  the  program  does.  What  does  32  or  47  or  3A  mean? 
Memorizing  a  card  full  of  codes  is  hardly  an  appetizing  proposition.  Furthermore,  the 
codes  will  be  entirely  different  for  a  different  microprocessor,  and  the  program  will  re- 
quire a  large  amount  of  documentation. 


Table  1-1.  Hexadecimal  Conversion  Table 


Hexadecimal 

Binary 

Decimal 

Digit 

Equivalent 

Equivalent 

0 

0000 

0 

1 

0001 

1 

2 

0010 

2 

3 

0011 

3 

4 

0100 

4 

5 

0101 

5 

6 

0110 

6 

7 

0111 

7 

8 

1000 

8 

9 

1001 

9 

A 

1010 

10 

B 

1011 

11 

C 

1100 

12 

D 

1101 

13 

E 

1110 

14 

F 

1111 

15 

INSTRUCTION  CODE  MNEMONICS 

An  obvious  programming  improvement  is  to  assign  a  name  to  each  instruction 
code.  The  instruction  code  name  is  called  a  "mnemonic",  or  memory  jogger.  The 
instruction  mnemonic  should  describe  in  some  way  what  the  instruction  does. 

In  fact,  every  microprocessor  manufacturer  (they  can't  remember  PROBLEM 
hexadecimal  codes  either)  provides  a  set  of  mnemonics  for  the  WITH 
microprocessor  instruction  set.  You  do  not  have  to  abide  by  the  MNEMONICS 
manufacturer's  mnemonics;  there  is  nothing  sacred  about  them. 
However,  they  are  standard  for  a  given  microprocessor  and  therefore  understood  by  all 
users.  These  are  the  instruction  names  that  you  will  find  in  manuals,  cards,  books,  arti- 
cles, and  programs.  The  problem  with  selecting  instruction  mnemonics  is  that  not  all  in- 
structions have  "obvious"  names.  Some  instructions  do  have  obvious  names  (e.g.. 
ADD.  AND,  OR),  others  have  obvious  contractions  (e.g..  SUB  for  subtraction,  XOR  for 
exclusive  OR),  while  still  others  have  neither.  The  result  is  such  mnemonics  as  WMP, 
PCHL  and  even  SOB  (try  and  guess  what  that  means!).  Most  manufacturers  come  up 
with  mostly  reasonable  names  and  a  few  hopeless  ones.  However,  users  who  devise 
their  own  mnemonics  rarely  seem  to  do  much  better  than  the  manufacturer. 


1-4 


Along  with  the  instruction  mnemonics,  the  manufacturer  will  usually  assign  names  to 
the  CPU  registers.  As  with  the  instruction  names,  some  register  names  are  obvious  (e.g.. 
A  for  Accumulator)  while  others  may  have  only  historical  Significance.  Again,  we  will 
use  the  manufacturer  s  suggestions  simply  to  promote  standardization. 

If  we  use  standard  Z80  instruction  and 
defined  by  Zilog,  our  Z80  addition  pro 

LD 
LD 
LD 
ADD 
LD 

The  program  is  still  far  from  obvious,  but  at  least  some  parts  are  comprehensible. 
ADD  A,B  is  a  considerable  improvement  over  80;  LD  does  suggest  loading  data  into  a 
register  or  memory  location.  Such  a  program  is  an  assembly  language  program. 

THE  ASSEMBLER  PROGRAM 

How  do  we  get  the  assembly  language  program  into  the  com- 
puter' We  have  to  translate  it,  either  into  hexadecimal  or  into  bin- 
ary numbers.  You  can  translate  an  assembly  language  program 
by  hand,  instruction  by  instruction.  This  is  called  hand  assembly. 

Hand  assembly  of  the  addition  program's  instruction  codes  may  be  illustrated  as 
follows: 


Instruction  Name 

Hexadecimal  Equivalent 

LD 

A,(NN) 

3A 

LD 

B,A 

47 

ADD 

A,B 

80 

LD 

(NN),A 

32 

As  in  the  case  of  hexadecimal  to  binary  conversion,  hand  assembly  is  a  rote  task  which 
is  uninteresting,  repetitive,  and  subject  to  numerous  minor  errors.  Picking  the  wrong 
line,  transposing  digits,  omitting  instructions,  and  misreading  the  codes  are  only  a  few 
of  the  mistakes  that  you  may  make.  Most  microprocessors  complicate  the  task  even 
further  by  having  instructions  with  different  word  lengths.  Some  instructions  are  one 
word  long  while  others  are  two  or  three  words  long.  Some  instructions  require  data  in 
the  second  and  third  words;  others  require  memory  addresses,  register  numbers,  or 
who  knows  what? 

Assembly  is  another  rote  task  that  we  can  assign  to  the 
microcomputer.  The  microcomputer  never  makes  any 
mistakes  when  translating  codes;  it  always  knows  how  many 
words  and  what  format  each  instruction  requires.  The  program 
that  does  this  Job  is  called  an  "assembler".  The  assembler 
program  translates  a  user  program,  or  "source"  program  writ- 
ten with  mnemonics,  into  a  machine  language  program,  or 
"object"  program,  which  the  microcomputer  can  execute.  The 
assembler's  input  is  a  source  program  and  its  output  is  an  object  program. 

The  tradeoffs  we  discussed  in  connection  with  the  hexadecimal  loader  are  mag- 
nified in  the  case  of  the  assembler.  Assemblers  are  more  expensive,  occupy  more 
memory,  and  require  more  peripherals  and  execution  time  than  do  hexadecimal 
loaders.  While  users  may  (and  often  do)  write  their  own  loaders,  few  care  to  write  their 
own  assemblers. 


I  register  mnemonics,  as 
jgram  becomes: 

A,  (60H) 

B,  A 

.A,{61H) 
A,B 

(62H),A 


ASSEMBLY 
LANGUAGE 
PROGRAM 


HAND 
ASSEMBLY 


ASSEMBLER 

SOURCE 
PROGRAM 

OBJECT 
PROGRAM 
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Assemblers  have  their  own  rules  that  you  must  learn  to  abide  by.  These  include  the 
use  of  certain  markers  (such  as  spaces,  commas,  semicolons,  or  colons)  in  appropriate 
places,  correct  spelling,  the  proper  control  information,  and  perhaps  even  the  correct 
placement  of  names  and  numbers.  These  rules  typicallv  are  a  minor  hindrance  that  can 
be  quickly  overcome. 

ADDITIONAL  FEATURES  OF  ASSEMBLERS 

Early  assembler  programs  did  little  more  than  translate  the  mnemonic  names  of  instruc- 
tions and  registers  into  their  binary  equivalents.  However,  most  assemblers  now  pro- 
vide such  additional  features  as: 

1)  Allowing  the  user  to  assign  names  to  memory  locations,  input  and  output  devices, 
and  even  sequences  of  instructions. 

2)  Converting  data  or  addresses  from  various  number  systems  (e.g.,  decimal  or  hex- 
adecimal) to  binary  and  converting  characters  into  their  ASCII  or  EBCDIC  binary 
codes. 

3)  Performing  some  arithmetic  as  part  of  the  assembly  process. 

4)  Telling  the  loader  program  where  in  memory  parts  of  the  program  or  data  should  be 
placed. 

5)  Allowing  the  user  to  assign  areas  of  memory  as  temporary  data  storage  and  to 
place  fixed  data  in  areas  of  program  memory. 

6)  Providing  the  information  required  to  include  standard  programs  from  program  li- 
braries, or  programs  written  at  some  other  time,  in  the  current  program. 

7)  Allowing  the  user  to  control  the  format  of  the  program  listing  and  the  input  and 
output  devices  employed. 

All  of  these  features,  of  course,  involve  additional  cost  and  memo- 
n/.  Microcomputers  generally  have  much  simpler  assemblers  than 
do  larger  computers,  but  the  tendency  always  is  for  the  size  of  as- 
semblers to  increase.  You  will  often  have  a  choice  of  assemblers. 
The  important  criterion  is  not  how  many  offbeat  features  the  assembler  has,  but  rather 
how  convenient  it  is  to  work  with  in  normal  practice. 

DISADVANTAGES  OF  ASSEMBLY  LANGUAGE 

The  assembler,  like  the  hexadecimal  loader,  does  not  solve  all  the  problems  of 
programming.  One  problem  is  the  tremendous  gap  between  the  microcomputer  in- 
struction set  and  the  tasks  which  the  microcomputer  is  to  perform.  Computer  in- 
structions tend  to  do  things  like  add  the  contents  of  two  registers,  shift  the  contents  of 
the  Accumulator  one  bit,  or  place  a  new  value  into  the  Program  Counter.  On  the  other 
hand,  a  user  generally  wants  a  microcomputer  to  do  something  like  check  if  an  analog 
reading  has  exceeded  a  threshold,  look  for  and  react  to  a  particular  command  from  a 
teletypewriter,  or  activate  a  relay  at  the  proper  time.  An  assembly  language  program- 
mer must  translate  such  tasks  into  a  sequence  of  simple  computer  instructions.  The 
translation  can  be  a  difficult,  time-consuming  job. 

Furthermore,  if  you  are  programming  in  assembly  language,  you  must  have  detailed 
knowledge  of  the  particular  microcomputer  that  you  are  using.  You  must  know 
what  registers  and  instructions  the  microcomputer  has,  precisely  how  the  instructions 
affect  the  various  registers,  what  addressing  methods  the  computer  uses,  and  a  myriad 
of  other  information.  None  of  this  information  is  relevant  to  the  task  which  the 
microcomputer  must  ultimately  perform. 

In  addition,  assembly  language  programs  are  not  portable.        |  PORTABILITY  f 

Each  microcomputer  has  its  own  assembly  language,  which 

reflects  its  own  architecture.  An  assembly  language  program  wntten  for  the  Z80  will 
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AN 
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not  run  on  the  Motorola  6800,  the  Fairchild  F8.  or  the  National  Semiconductor  PACE. 
For  example,  the  addition  program  written  for  the  Motorola  6800  would  be: 

LDAA  $60 
ADDA  $61 
STAA  $62 

The  lack  of  portability  not  only  means  that  you  won't  be  able  to  use  your  assembly 
language  program  on  another  microcomputer,  but  it  also  means  that  you  won't  be  able 
to  use  any  programs  that  weren't  specifically  written  for  the  microcomputer  you  are 
using.  This  is  a  particular  drawback  for  microcomputers,  since  these  devices  are  new 
and  few  assembly  language  programs  exist  for  them.  The  result,  too  frequently,  is  that 
you  are  on  your  own.  If  you  need  a  program  to  perform  a  particular  task,  you  are  not 
likely  to  find  it  in  the  small  program  libraries  that  most  manufacturers  provide.  Nor  are 
you  likely  to  find  it  in  an  archive,  journal  article,  or  someone's  old  program  file.  You  will 
probably  have  to  write  it  yourself. 

HIGH-LEVEL  LANGUAGES 

The  solution  to  many  of  the  difficulties  associated  with  as-  |  COMPILER  | 
sembly  language  programs  is  to  use,  instead,  "high-level"  or  i— — — J 
"procedure-oriented"  languages.  Such  languages  allow  you  to  describe  tasks  in 
forms  that  are  problem  oriented  rather  than  computer  oriented.  Each  statement  in 
a  high-level  language  performs  a  recognizable  function;  it  will  generally  corres- 
pond to  many  assembly  language  instructions.  A  program  called  a  compiler  transl- 
ates the  high-level  language  source  program  into  object  code  or  machine  language 
instructions. 

Many  different  high-level  languages  exist  for  different  types  of  [FORTRAN 
tasks.  If,  for  example,  you  can  express  what  you  want  the  com-  l_— — — J 
puter  to  do  in  algebraic  notation,  you  can  write  your  program  in  FORTRAN  (Formula 
Translation  Language),  the  oldest  and  one  of  the  most  widely  used  of  the  high-level 
languages.  Now,  if  you  want  to  add  two  numbers,  you  just  tell  the  computer: 

SUM  =NUMB1+NUMB2 

That  is  a  lot  simpler  (and  a  lot  shorter)  than  either  the  equivalent  machine  language  pro- 
gram or  the  equivalent  assembly  language  program.  Other  high-level  languages  in- 
clude COBOL  (for  business  applications),  PASCAL  (another  algebraic  language),  PL/1  (a 
combination,  of  FORTRAN,  ALGOL,  and  COBOL),  and  APL  and  BASIC  (languages  that 
are  popular  for  time-sharing  systems). 

ADVANTAGES  OF  HIGH-LEVEL  LANGUAGES 

Clearly,  high-level  languages  make  programs  easier  and  faster  to  write.  A  common 
estimate  is  that  a  programmer  can  write  a  program  about  ten  times  as  fast  in  a 
high-level  language  as  compared  to  assembly  language.  That  is  just  writing  the  pro- 
gram: it  does  not  include  problem  definition,  program  design,  debugging,  testing,  or 
documentation,  all  of  which  become  simpler  and  faster.  The  high-level  language  pro- 
gram IS,  for  instance,  partly  self-documenting.  Even  if  you  do  not  know  FORTRAN,  you 
probably  could  tell  what  the  statement  illustrated  above  does. 

High-level  languages  solve  many  other  problems  associ- 
ated with  assembly  language  programming.  The  high-level 
language  has  its  own  syntax  (usually  defined  by  a  national  or 
international  standard).  The  language  does  not  mention  the  in- 
struction set,  registers,  or  other  features  of  a  particular  com- 
puter. The  compiler  takes  care  of  all  such  details.  Programmers  can  concentrate  on  their 
own  tasks:  they  do  not  need  a  detailed  understanding  of  the  underlying  CPU  architec- 
ture —  for  that  matter,  they  do  not  need  to  know  anything  about  the  computer  they  are 
programming. 
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Programs  written  In  a  high-level  language  are  portable  — 
at  least,  in  theory.  They  will  run  on  any  computer  or 
microcomputer  that  has  a  standard  compiler  for  that  language. 

At  the  same  time,  all  previous  programs  written  m  a  high-level 

language  for  prior  computers  are  available  to  you  when  programming  a  new  computer 
This  can  mean  thousands  of  programs  in  the  case  of  a  common  language  like  FORTRAN 
or  BASIC. 

DISADVANTAGES  OF  HIGH-LEVEL  LANGUAGES 

Well,  if  all  the  good  things  we  have  said  about  high-level  languages  are  true,  if  you 
can  write  programs  faster  and  make  them  portable  besides,  why  bother  with  as- 
sembly languages?  Who  wants  to  worry  about  registers,  instruction  codes, 
mnemonics,  and  all  that  garbage!  As  usual,  there  are  disadvantages  that  balance 
the  advantages. 

One  obvious  problem  is  that  you  have  to  learn  the  "rules"  or 
"syntax"  of  any  high-level  language  you  want  to  use.  A  high- 
level  language  has  a  fairly  complicated  set  of  rules.  You  will  find 
that  it  tal<es  a  lot  of  time  lust  to  get  a  program  that  is  syntactically 
correct  (and  even  then  it  probably  will  not  do  what  you  want).  A  high-level  computer 
language  is  lil<e  a  foreign  language.  If  you  have  a  little  talent,  you  will  get  used  to  the 
rules  and  be  able  to  turn  out  programs  that  the  compiler  will  accept.  Still,  learning  the 
rules  and  trying  to  get  the  program  accepted  by  the  compiler  doesn't  contribute 
directly  to  doing  your  |ob. 

Here,  for  example,  are  some  FORTRAN  rules; 

•  Labels  must  be  numbers  placed  in  the  first  five  card  columns 

•  Statements  must  start  in  column  seven 

•  Integer  variables  must  start  with  the  letters  I,  J,  K.  L,  M.  or  N 
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Another  obvious  problem  is  that  you  need  a  compiler  to  transl- 
ate programs  written  in  a  high-level  language.  Compilers  are 
expensive  and  use  a  large  amount  of  memory.  While  most  assem- 
blers occupy  2K  to  16K  bytes  of  memory  (1K  =  1024),  compilers  occupy  4K  to  64K 
bytes.  So  the  amount  of  overhead  involved  in  using  the  compiler  is  rather  large. 

Furthermore,  only  some  compilers  will  make  the  implementa- 
tion of  your  task  simpler.  FORTRAN,  for  example,  is  well-suited 
to  problems  that  can  be  expressed  as  algebraic  formulas.  If, 
however,  your  problem  is  controlling  a  printer,  editing  a  string  of  characters,  or  monitor- 
ing an  alarm  system,  your  problem  cannot  be  easily  expressed  in  algebraic  notation.  In 
fact,  formulating  the  solution  in  algebraic  notation  may  be  more  awkward  and  more 
difficult  than  formulating  it  in  assembly  language.  One  answer  is  to  use  a  more  suitable 
high-level  language.  Some  such  languages  exist,  but  they  are  far  less  widely  used  and 
standardized  than  FORTRAN.  You  will  not  get  many  of  the  advantages  of  high-level 
languages  if  you  use  these  so-called  system  implementation  languages. 

High-level  languages  do  not  produce  very  efficient 
machine  language  programs.  The  basic  reason  for  this  is  that 
compilation  is  an  automatic  process  which  is  riddled  with  com- 
promises to  allow  for  many  ranges  of  possibilities.  The  com- 
piler works  much  like  a  computerized  language  translator  —  sometimes  the  words  are 
right  but  the  sounds  and  sentence  structures  are  awkward.  A  simple  compiler  cannot 
know  when  a  variable  is  no  longer  being  used  and  can  be  discarded,  or  when  a  register 
should  be  used  rather  than  a  memory  location,  or  when  variables  have  simple  relation- 
ships. The  experienced  programmer  can  take  advantage  of  shortcuts  to  shorten  execu- 
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tion  time  or  reduce  memory  usage.  A  few  compilers  (l<nown  as  optimizing  compilers) 
can  also  do  this,  but  such  compilers  are  much  larger  and  slower  than  regular  compilers. 

The  general  advantages  and  disadvantages  of  high-level  languages  are: 

Advantages: 

■  More  convenient  descriptions  of  tasks 

•  More  efficient  program  coding 

•  Easier  documentation 

•  Standard  syntax 

•  Independence  of  the  structure  of  a  particular  computer 

•  Portability 

•  Availability  of  library  and  other  programs 
Disadvantages: 

■  Special  rules 

•  Extensive  hardware  and  software  support  required 

•  Orientation  of  common  languages  to  algebraic  or  business 
problems 

•  Inefficient  programs 

•  Difficulty  of  optimizing  code  to  meet  time  and  memory  requirements 

•  Inability  to  use  special  features  of  a  computer  conveniently 

HIGH-LEVEL  LANGUAGES  FOR  MICROPROCESSORS 

Microprocessor  users  will  encounter  several  special  difficulties  when  using  high- 
level  languages.  Among  these  are: 

•  Few  high-level  languages  exist  for  microprocessors 

•  No  standard  languages  are  widely  available 

•  Few  compilers  actually  run  on  microcomputers.  Those  that  do  often  require  very  large 
amounts  of  memory. 

•  Most  microprocessor  applications  are  not  well-suited  to  high-level  languages. 

•  Memory  costs  are  often  critical  in  microprocessor  applications. 

The  lack  of  high-level  languages  is  partly  a  result  of  the  fact  that  microprocessors  are 
quite  new  and  are  the  products  of  semiconductor  manufacturers  rather  than  computer 
manufacturers. 

Very  few  high-level  languages' exist  for  microprocessors.  The  most  common  are  the 
PL/1  type  languages  teuch  as  Intel's  PL/M.  Motorola's  MPL,  and  Signetics'  PLmS), 
BASIC,  and  PASCAL. 

Even  the  few  high-level  languages  that  exist  do  not  conform  to  recognized  standards, 
so  the  microprocessor  user  cannot  expect  to  gain  much  program  portability,  access  to 
program  libraries,  or  use  of  previous  experience  or  programs.  The  main  advantages  re- 
maining are  the  reduction  in  programming  effort  and  the  smaller  amount  of  detailed 
understanding  of  the  computer  architecture  that  is  necessary. 

The  overhead  involved  in  using  a  high-level  language  with 
microprocessors  is  considerable.  Microprocessors  themselves  are 
better  suited  to  control  and  slow  interactive  applications  than  they 
are  to  the  character  manipulation  and  language  analysis  involved 
in  compilation.  Therefore,  most  compilers  for  microprocessors  will 
not  run  on  a  microprocessor-based  system.  Instead,  they  require  a  much  larger  com- 
puter, i.e..  they  are  cross-compilers  rather  than  self-compilers.  A  user  must  not  only 
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bear  the  expense  of  the  larger  computer  but  must  also  physically  transfer  the  program 
from  the  larger  computer  to  the  micro. 

A  few  self-compilers  are  available.  These  compilers  run  on  the  microcomputer  for 
which  they  produce  object  code.  Unfortunately,  they  require  large  amounts  of  memory 
(16K  or  more),  plus  special  supporting  hardware  and  software. 

High-level  languages  also  are  not  generally  well-suited  to 
microprocessor  applications.  Most  of  the  common  languages 
were  devised  either  to  help  solve  scientific  problems  or  to  han- 
dle large-scale  business  data  processing.  Few  microprocessor 
applications  fall  in  either  of  these  areas.  Most  microprocessor  applications  involve  send- 
ing data  and  control  information  to  output  devices  and  receiving  data  and  status  infor- 
mation from  input  devices.  Often  the  control  and  status  information  consists  of  a  few 
binary  digits  with  very  precise  hardware-related  meanings.  If  you  try  to  write  a  typical 
control  program  in  a  high-level  language,  you  often  feel  like  someone  who  is  trying  to 
eat  soup  with  chopsticks  For  tasks  in  such  areas  as  test  equipment,  terminals,  naviga- 
tion systems,  signal  processing,  and  business  equipment,  the  high-level  languages 
work  much  better  than  they  do  in  instrumentation,  communications,  penpherals,  and 
automotive  applications. 

Applications  better  suited  to  high-level  languages  are  those  which 
require  large  memories.  If,  as  in  a  valve  controller,  electronic  game, 
appliance  controller,  or  small  instrument,  the  cost  of  a  single 
memory  chip  is  important,  then  the  inefficiency  of  high-level 
languages  is  intolerable.  If,  on  the  other  hand,  as  in  a  terminal  or 
test  equipment,  the  system  has  many  thousands  of  bytes  of  memory  anyway,  the  ineffi- 
ciency of  high-level  languages  is  not  as  important.  Clearly  the  size  of  the  program  and 
the  volume  of  the  product  are  important  factors  as  well.  A  large  program  will  greatly  in- 
crease the  advantages  of  high-level  languages.  On  the  other  hand,  a  high-volume  ap- 
plication will  mean  that  fixed  software  development  costs  are  not  as  important  as 
memory  costs  that  are  part  of  each  system. 

WHICH  LEVEL  SHOULD  YOU  USE? 

That  depends  on  your  particular  application.  Let  us  briefly  note  some  of  the  factors 
which  may  favor  particular  levels: 


APPLICATION 
AREAS  FOR 
LANGUAGE 
LEVELS 


Machine  Language: 

•  Virtually  no  one  programs  in  machine  language,  its  use  can- 
not be  justified  considering  the  low  cost  of  an  assembler  and 
the  increase  in  programming  speed  an  assembler  provides. 

Assembly  Language: 

■  Short  to  moderate  sized  programs 

■  Applications  where  memory  cost  is  a  factor 

•  Real-time  control  applications 

■  Limited  data  processing 

•  High-volume  applications 

■  More  input/output  or  control  than  computation 
High-Level  Languages: 

•  Long  programs 

•  Low-volume  applications  requiring  long  programs 

■  Applications  requiring  large  memories 


APPLICATIONS 
FOR  MACHINE 
LANGUAGE 


APPLICATIONS 
FOR  ASSEMBLY 
LANGUAGE 


APPLICATIONS 
FOR  HIGH-LEVEL 
LANGUAGE 
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■  More  computation  than  input/output  or  control 

•  Compatibility  with  similar  applications  using  larger  computers 

■  Availability  of  specific  programs  in  a  high-level  language  which  can  be  used  in 
the  application 

Many  other  factors  are  also  important,  such  as  the  availability  of  a  larger  computer  for 
use  in  development,  experience  with  particular  languages,  and  compatibility  w/ith  other 
applications. 

If  hardware  will  ultimately  be  the  largest  cost  in  your  application,  or  if  speed  is  critical 
you  should  favor  assembly  language.  But  be  prepared  to  spend  extra  time  in  software 
development  in  exchange  for  lower  memory  costs  and  higher  execution  speeds.  If  soft- 
ware will  be  the  largest  cost  in  your  application,  you  should  favor  a  high-level  language. 
But  be  prepared  to  spend  the  extra  money  required  for  the  supporting  hardware  and 
software. 

Of  course,  no  one  except  some  theorists  will  object  if  you  use  both  assembly  and  high- 
level  languages.  You  can  write  the  program  onginally  in  a  high-level  language  and  then 
patch  some  sections  in  assembly  language.  However,  most  users  prefer  not  to  do  this 
because  of  the  havoc  it  creates  in  debugging,  testing,  and  documentation. 

HOW  ABOUT  THE  FUTURE? 

We  expect  that  the  future  will  tend  to  favor  high-level  languages  for  the  following 
reasons: 

•  Programs  always  seem  to  add  extra  features  and  grow  larger 

•  Hardware  and  memory'  are  becoming  less  expensive 

•  Software  and  programmers  are  becoming  more  expensive 

•  Memory  chips  are  becoming  available  in  larger  sizes,  at  lower 
"per  bit"  cost,  so  actual  savings  in  chips  are  less  likely 

•  More  compilers  are  becoming  available 

•  More  suitable  and  more  efficient  high-level  languages  are  being  developed 

■  More  standardization  of  high-level  languages  will  occur 

Assembly  language  programming  of  microprocessors  will  not  be  a  dying  art  any  more 
than  it  IS  now  for  large  computers.  But  longer  programs,  cheaper  memory,  and  more  ex- 
pensive programmers  will  make  software  costs  a  larger  part  of  most  applications.  The 
edge  in  many  applications  will  therefore  go  to  high-level  languages. 

WHY  THIS  BOOK? 

If  the  future  would  seem  to  favor  high-level  languages,  why  have  a  book  on  as- 
sembly language  programming?  The  reasons  are: 

1)  Most  current  microcomputer  users  program  in  assembly  language  (almost  two- 
thirds,  according  to  one  recent  survey). 

2)  Many  microcomputer  users  will  continue  to  program  in  assembly  language  since 
they  need  the  detailed  control  that  it  provides. 

3)  No  suitable  high-level  language  has  yet  become  widely  available  or  standardized. 

4)  Many  applications  require  the  efficiency  of  assembly  language. 

5)  An  understanding  of  assembly  language  can  help  in  evaluating  high-level 
languages. 

The  rest  of  this  book  will  deal  exclusively  with  assemblers  and  assembly  language  pro- 
gramming. However,  we  do  want  readers  to  know  that  assembly  language  is  not  the 
only  alternative.  You  should  watch  for  new  developments  that  may  significantly  reduce 
programming  costs  if  such  costs  are  a  major  factor  in  your  application. 


FUTURE  TRENDS 
IN  LANGUAGE 
LEVELS 
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Chapter  2 
ASSEMBLERS 


This  chapter  discusses  the  functions  performed  by  assemblers,  beginning  with  features 
common  to  most  assemblers,  and  proceeding  through  more  elaborate  capabilities  such 
as  macros  and  conditional  assembly.  You  may  wish  to  skim  this  chapter  for  the  present 
and  return  to  it  when  you  feel  more  comfortable  with  the  material. 


FEATURES  OF  ASSEMBLERS 

As  we  mentioned  previously,  today's  assemblers  do  much  more  than  translate  as- 
sembly language  mnemonics  into  binary  codes.  But  we  will  first  describe  how  an 
assembler  handles  the  translation  of  mnemonics  before  describing  additional  as- 
sembler features.  Finally,  we  will  explain  how  assemblers  are  used. 

ASSEMBLER  INSTRUCTIONS 

Assembly  language  instructions  (or  "statements")  are  divided 
into  a  number  of  fields,  as  shown  in  Table  2-1. 

The  operation  code  field  is  the  only  field  which  can  never  be 
empty;  it  always  contains  either  an  instruction  mnemonic  or  a 
directive  to  the  assembler,  called  a  pseudo-instruction,  pseudo-operation,  or 
pseudo-op. 

The  address  field  may  contain  an  address  or  data,  or  it  may  be  blank. 


Table  2-1.  The  Fields  of  an  Assembly  Language  Instruction 


Label 
Field 

Operation 
Code  or 
Mnemonic 
Field 

Operand 
or 

Address 
Field 

Comment  Field 

START; 

LD 

A,(VAL1) 

LOAD  FIRST  NUMBER  INTO  A 

LD 

B.A 

SAVE  IN  B 

LD 

A,(VAL2i 

LOAD  SECOND  NUMBER  INTO  A 

ADD 

A.B 

ADD  FIRST  NUMBER  TO  A 

LD 

(SUM).A 

STORE  SUM 

NEXT; 

7 

■> 

NEXT  INSTRUCTION 

VAL1 ; 

DEFS 

1 

VAL2: 

DEFS 

1 

SUM: 

DEFS 

1 

The  comment  and  label  fields  are  optional.  A  programmer  will  assign  a  label  to  a 
statement  or  add  a  comment  as  a  personal  convenience,  e.g.,  to  make  the  program 
easier  to  code  and  read. 


ASSEMBLY 
LANGUAGE 
FIELDS 
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Of  course,  the  assembler  must  have  some  way  of  telling  I  FORMAT  I 

where  one  field  ends  and  another  begins.  Assemblers  that  use 
punched  card  input  often  require  that  each  field  start  in  a  specific  card  column.  This  is 
a  fixed  format.  However,  fixed  formats  may  be  inconvenient  when  the  input  medium  is 
paper  tape;  fixed  formats  are  also  a  nuisance  to  programmers.  The  alternative  is  a  free 
format,  where  the  fields  may  appear  anywhere  on  the  line. 


DELIMITERS 


If  the  assembler  cannot  use  the  position  in  the  line  to  tell  the  fields 
apart,  it  must  use  something  else.  Most  assemblers  use  a 
special  symbol  or  delimiter  at  the  beginning  or  end  of  each  field.  The  most  obvious 
delimiter  is  the  space  character.  Commas,  periods,  semicolons,  colons,  slashes,  ques- 
tion marks  and  other  characters  that  would  not  othen/vise  be  used  in  assembly 
language  programs  also  may  serve  as  delimiters.  Table  2-2  lists  standard  Zilog  Z80  as- 
sembler delimiters. 

Table  2-2.  Standard  Z80  Assembler  Delimiters 


:  after  a  label 

'space'  between  operation  code  and  address 

,  between  operands  in  the  address  field 

;  before  a  comment 


LABEL 
FIELD 


You  will  have  to  exercise  a  little  care  with  delimiters.  Some  assemblers  are  fussy 
about  extra  spaces  or  the  appearance  of  delimiters  in  comments  or  labels.  A  well- 
written  assembler  will  handle  these  minor  problems,  but  many  assemblers  are  not 
well-written.  Our  recommendation  is  simple:  avoid  potential  problems  if  you  can. 
The  following  rules  will  help: 

1)  Do  not  use  extra  spaces,  particularly  after  commas  that  separate  operands. 

2)  Do  not  use  delimiter  characters  in  names  or  labels. 

3)  Include  standard  delimiters  even  if  your  assembler  does  not  require  them.  Your  pro- 
grams will  then  be  assembled  by  any  assembler. 

LABELS 

The  label  field  is  the  first  field  in  an  assembly  language  in- 
struction: It  may  be  blank.  If  a  label  is  present,  the  assembler 
assigns  to  the  label  the  value  of  the  address  for  the  memory  loca- 
tion into  which  the  first  object  program  byte  for  that  instruction  is  loaded.  You  may 
subsequently  use  the  label  as  data  or  as  an  address  in  another  instruction's  operand 
field.  The  assembler  will  replace  the  label  with  the  assigned  value  when  creating  an  ob- 
lect  program. 

Labels  are  most  frequently  used  in  Jump,  Call  or  Branch  in- 
structions. These  instructions  place  a  new  value  in  the  Program 
Counter  and  so  alter  the  normal  sequential  execution  of  instruc- 
tions. JUMP  150-I6  means  "place  the  value  150-|g  into  the  Pro- 
gram Counter".  The  next  instruction  to  be  executed  will  be  the  one  in  memory  location 
150ig.  The  instruction  JUMP  START  means  "place  the  value  assigned  to  the  label 
START  into  the  Program  Counter"  The  next  instruction  to  be  executed  will  be  the  one 
in  the  memory  location  to  which  the  label  START  has  been  assigned.  Table  2-3  contains 
an  example. 


LABELS 

IN  JUMP 

INSTRUCTIONS 
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Table  2-3.  Assigning  and  Using  a  Label 


ASSEMBLY  LANGUAGE  PROGRAM 
START         LOAD  ACCUMULATOR  100 

(MAIN  PROGRAM) 
JUMP  START 


When  the  machine  language  version  of  this  program  is  executed,  the  instruction  JUMP 
START  causes  the  address  of  the  instruction  labeled  START  to  be  placed  into  the  Pro- 
gram Counter.  The  instruction  with  the  label  START  will  be  executed  next. 

Why  use  a  label?  Here  are  some  reasons: 


11 
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A  label  makes  a  program  location  easier  to  find  and  remember. 
The  label  can  be  moved  to  change  or  correct  a  program.  You  do  not  have  to  change 
any  subsequent  instructions  that  use  the  label;  the  assembler  will  make  all  the 
necessary  changes. 


RELOCATION 
CONSTANT 


3)  The  assembler  or  loader  can  relocate  the  whole  program  by 
adding  a  constant  (a  relocation  constant)  to  each  address  in 
which  a  label  was  used.  Thus  we  can  move  the  program  to 
allow  for  the  insertion  of  other  programs  or  simply  to  rearrange  memory. 

4)  The  program  is  easier  to  use  as  a  libran/  program,  i.e..  it  is  easier  for  someone  else  to 
take  your  program  and  add  it  to  some  totally  different  program. 

5)  You  do  not  have  to  figure  out  memory  addresses.  Figuring  out  memory  addresses  is 
particularly  difficult  with  microprocessors  which  have  instructions  that  vary  in 
length. 

It  makes  sense  to  assign  a  label  to  any  instruction  that  you  might  want  to  use  as  a 
destination  or  othen/vise  identify. 


The  next  question  is  what  label  to  use.  The  assembler  often  CHOOSING 
places  some  restrictions  on  the  number  of  characters  (usually  5  LABELS 
or  6),  the  leading  character  (often  must  be  a  letter),  and  the  trailing 
characters  (often  must  be  letters,  numbers,  or  one  of  a  few  special  characters).  Beyond 
these  restrictions,  the  choice  is  up  to  you. 

Our  own  preference  is  to  use  labels  that  suggest  their  purpose,  i.e.,  mnemonic  labels. 
Typical  examples  are  ADDW  in  a  routine  that  adds  one  word  into  a  sum,  SRETX  in  a 
routine  that  searches  for  the  ASCII  character  ETX,  or  NKEYS  for  a  location  in  data 
memory  that  contains  the  number  of  key  entries.  Meaningful  labels  are  easier  to 
remember  and  contribute  to  program  documentation.  Some  programmers  prefer  to  use 
a  standard  format  for  labels,  such  as  starting  with  LOOOO.  These  labels  are  self-sequenc- 
ing (you  can  skip  a  few  numbers  to  permit  insertions),  but  they  do  not  help  document 
the  program. 

Some  label  selection  rules  will  keep  you  out  of  trouble.  We  RULES  OF 

recommend  the  following:  LABELING 


1)    Do  not  use  labels  that  are  the  same  as  operation  codes  or 

other  mnemonics.  Most  assemblers  will  not  allow  this  usage;  others  will,  but  it  is 
very  confusing. 
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2)  Do  not  use  labels  that  are  longer  than  the  assembler  permits.  Assemblers  have 
various  truncation  rules. 

3)  Avoid  special  characters  (non-alphabetic  and  non-numeric)  and  lower-case  letters. 
Some  assemblers  will  not  permit  them;  others  allow  only  certain  ones.  The  simplest 
practice  is  to  stick  to  capital  letters  and  numbers. 

4)  Start  each  label  with  a  letter.  Such  labels  are  always  acceptable. 

5)  Do  not  use  labels  that  could  be  confused  with  each  other.  Avoid  the  letters  I.  0  and 
Z  and  the  numbers  0.  1  and  2.  Also  avoid  things  like  XXXX  and  XXXXX.  There's  no 
sense  tempting  fate  and  Murphy's  laws. 

6)  When  you  are  not  sure  if  a  label  is  legal,  do  not  use  it.  You  will  not  get  any  real 
benefit  from  discovering  exactly  what  the  assembler  will  accept. 

These  are  recommendations,  not  rules.  You  do  not  have  to  follow  them,  but  don't  blame 
us  if  you  waste  time  on  silly  problems. 

ASSEMBLER  OPERATION  CODES  (MNEMONICS) 

The  main  task  of  the  assembler  is  the  translation  of  mnemonic  operation  codes 
into  their  binary  equivalents.  The  assembler  performs  this  task  using  a  fixed  table 
much  as  you  would  if  you  were  doing  the  assembly  by  hand. 

The  assembler  must,  however,  do  more  than  |ust  translate  the  operation  codes  It  must 
also  somehow  determine  how  many  operands  the  instruction  requires  and  what 
type  they  are.  This  may  be  rather  complex  — some  instructions  (like  a  Halt)  have  no 
operands,  others  (like  an  Addition  or  a  Jump  instruction)  have  one,  while  still  others 
(like  a  transfer  between  registers  or  a  multiple-bit  shift)  require  two.  Some  instructions 
may  even  allow  alternatives,  e.g.,  some  computers  have  instructions  (like  Shift  or  Clear) 
that  can  apply  either  to  the  Accumulator  or  to  a  memory  location.  We  will  not  discuss 
how  the  assembler  makes  these  distinctions;  we  will  |ust  note  that  it  must  do  so. 

PSEUDO-OPERATIONS 

Some  assembly  language  instructions  are  not  directly  transl- 
ated into  machine  language  instructions.  These  instructions 
are  directives  to  the  assembler;  they  assign  the  program  to  cer- 
tain areas  in  memory,  define  symbols,  designate  areas  of  RAM  for 
temporary  data  storage,  place  tables  or  other  fixed  data  in  memo- 
ry, allow  references  to  other  programs,  and  perform  minor  house- 
keeping functions. 

To  use  these  assembler  directives,  or  pseudo-operations,  a  programmer  places  the 
pseudo-operation's  mnemonic  in  the  operation  code  field  and,  if  the  specified  pseudo- 
operation  requires  it,  an  address  or  data  in  the  address  field. 

The  most  common  pseudo-operations  are; 

DATA 

EQUATE  or  DEFINE 

ORIGIN 

RESERVE 

Linking  pseudo-operations  are; 

ENTRY 
EXTERNAL 


PSEUDO- 
OPERATIONS 

ASSEMBLER 
DIRECTIVE 
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Different  assemblers  use  different  names  for  these  operations,  but  the  purposes  are  the 
same.  Housekeeping  pseudo-operations  include: 

END 

LIST 

NAME 

PAGE 

SPACE 

TITLE 

We  will  discuss  these  pseudo-operations  briefly,  although  their  functions  are  usually 
obvious. 

THE  DATA  PSEUDO-OPERATION 

The  DATA  pseudo-operation  allows  the  programmer  to  enter  fixed  data  into 
memory.  This  data  may  include: 

•  Lookup  tables 

•  Code  conversion  tables 

•  Messages 

•  Synchronization  patterns 

■  Thresholds 

•  Names 

•  Coefficients  for  equations 

•  Commands 

■  Conversion  factors 

•  Weighting  factors 

•  Characteristic  times  or  frequencies 

•  Subroutine  addresses 

•  Key  identifications 

■  Test  patterns 

•  Character  generation  patterns 

•  Identification  patterns 

•  Tax  tables 

•  Standard  forms 

•  Masking  patterns 

•  State  transition  tables 

The  DATA  pseudo-operation  treats  the  data  as  a  permanent  part  of  the  program. 

The  format  of  a  DATA  pseudo-operation  is  usually  quite  simple.  An  instruction 
like: 

DZCON    DATA  12 

will  place  the  number  1 2  in  the  next  available  memory  location  and  assign  that 
location  the  name  DZCON.  Usually  every  DATA  pseudo-operation  has  a  label,  unless  it 
IS  one  of  a  series  of  DATA  pseudo-operations.  The  data  and  label  may  take  any  form 
that  the  assembler  permits. 

Most  assemblers  allow  more  elaborate  DATA  instructions  that  handle  a  large  amount  of 
data  at  one  time,  e.g.: 

EMESS     DATA  'ERROR' 
SQRS      DATA  1,4,9,16,25 
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A  single  instruction  may  fill  many  words  of  program  memory,  limited  only  by  the  length 
of  a  line.  Note  that  if  you  cannot  get  all  the  data  on  one  line,  you  can  always  follow  one 
DATA  instruction  with  another,  e.g.. 

MESSG     DATA      'NOW  IS  THE  ' 
DATA      TIME  FOR  ALL  ' 
DATA      'GOOD  MEN  ' 
DATA      TO  COME  TO  THE  ' 
DATA      'AID  OF  THEIR  ' 
DATA  'COUNTRY' 

Microprocessor  assemblers  typically  have  some  variations  of  standard  DATA 
pseudo-operations.  DEFINE  BYTE  or  FORM  CONSTANT  BYTE  handles  8-bit  numbers; 
DEFINE  WORD  or  FORM  CONSTANT  WORD  handles  16-bit  numbers  or  addresses. 
Other  special  pseudo-operations  may  handle  character-coded  data. 

THE  EQUATE  (or  DEFINE)  PSEUDO-OPERATION  

The  EQUATE  pseudo-operation  allows  the  programmer  to  DEFINING 
equate  labels  and  names  with  addresses  or  data.  This  pseudo-  NAMES 
operation  is  almost  always  given  the  mnemonic  EQU.  The 

names  may  refer  to  device  addresses,  numeric  data,  starting  addresses,  fixed  ad- 
dresses, etc. 

The  EQUATE  pseudo-operation  assigns  the  numeric  value  in  its  operand  field  to 
the  label  in  its  label  field.  Here  are  two  examples; 

TTY        EQU  5 
LAST       EQU  5000 

Most  assemblers  will  allow  you  to  define  one  label  in  terms  of  another,  e.g.; 

LAST       EQU  FINAL 
STl  EQU  START+1 

The  label  in  the  operand  field  must,  of  course,  have  been  previously  defined.  Often,  the 
operand  field  may  contain  more  complex  expressions,  as  we  shall  see  later.  Double 
name  assignments  (two  names  for  the  same  data  or  address)  may  be  useful  in  patching 
together  programs  which  use  different  names  for  the  same  variable  (or  different  spell- 
ings of  what  was  supposed  to  be  the  same  name). 


SYMBOL 
TABLE 


USE  OF 

l\JAIVIES 


Note  that  an  EQU  pseudo-operation  does  not  cause  the  as- 
sembler to  place  anything  into  memory.  The  assembler  simply 
enters  an  additional  name  into  a  table  (called  a  symbol  table) 
which  the  assembler  maintains.  This  table,  unlike  the  mnemonic  table,  must  be  in 
RAM  since  it  varies  with  each  program.  The  assembler  program  will  always  need  some 
RAM  to  hold  the  symbol  table;  the  more  RAM  it  has,  the  more  symbols  it  can  accept 
This  RAM  is  in  addition  to  any  which  the  assembler  needs  as  temporary  storage 

When  do  you  use  a  name?  The  answer  is;  whenever  you  have  a 
parameter  that  has  some  meaning  besides  its  ordinary  numeric 
value,  or  the  numeric  value  of  the  parameter  might  be  changed. 
We  typically  assign  names  to  time  constants,  device  addresses,  masking  patterns,  con- 
version factors,  and  the  like.  A  name  like  DELAY,  TTY.  KBD.  NROW,  or  OPEN  not  only 
makes  the  parameter  easier  to  change,  but  it  also  adds  to  program  documentation.  We 
also  assign  names  to  memory  locations  that  have  special  purposes;  they  may  hold  data, 
mark  the  start  of  the  program,  or  be  available  for  intermediate  storage. 

What  name  do  you  use?  The  best  rules  are  much  the  same  as 
in  the  case  of  labels,  except  that  here  meaningful  names  really 
count.  Why  not  call  the  teletypewnter  TTY  instead  of  XI 5,  a  bit 
time  delay  BTIME  or  BTDLY  rather  than  WW,  the  number  of  the 


CHOICE 
OF 

NAMES  I 
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"GO"  key  on  a  kevboard  GOKEY  rather  than  HORSE?  This  advice  seems  straightfor- 
ward, but  a  surprising  number  of  programmers  do  not  follow  it. 


Where  do  you  place  the  EQUATE  pseudo-operations?  The  PLACEMENT 
best  place  is  at  the  start  of  the  program,  under  appropriate  OF 
comment  headings  such  as  I/O  ADDRESSES,  TEMPORARY  DEFINITIONS 
STORAGE,  TIME  CONSTANTS,  or  PROGRAM  LOCATIONS.  This  «-— _ 
makes  the  definitions  easy  to  find  if  you  want  to  change  them.  Furthermore,  another 
user  will  be  able  to  look  up  all  the  definitions  in  one  centralized  place.  Clearly  this  prac- 
tice improves  documentation  and  makes  the  program  easier  to  use. 

Definitions  used  only  in  a  specific  subroutine  should  appear  at  the  start  of  the 
subroutine. 

THE  ORIGIN  PSEUDO-OPERATION 

The  ORIGIN  pseudo-operation  (almost  always  abbreviated  ORG)  allows  the  pro- 
grammer to  locate  programs,  subroutines,  or  data  anywhere  in  memory.  Programs 
and  data  may  be  located  in  different  areas  of  memory  depending  on  the  memory  con- 
figuration. Startup  routines,  interrupt  service  routines,  and  other  required  programs 
may  be  scattered  around  memory  at  fixed  or  convenient  addresses. 


LOCATION 
COUNTER 


The  assembler  maintains  a  Location  Counter  (comparable  to 
the  computer's  Program  Counter)  which  contains  the  location 
in  memory  at  which  the  next  byte  of  object  code  generated  by 
the  assembler  will  reside  when  the  program  is  loaded.  An  ORG  pseudo-operation 
causes  the  assembler  to  place  a  new  value  into  the  Location  Counter,  much  as  a  Jump 
instruction  causes  the  CPU  to  place  a  new  value  into  the  Program  Counter.  The  output 
from  the  assembler  must  not  only  contain  instructions  and  data,  but  must  also  indicate 
to  the  loader  program  where  in  memory  it  should  place  the  instructions  and  data. 

Microprocessor  programs  often  contain  several  ORIGIN  statements  for  the  following 
purposes; 

Reset  (startup)  address  Mam  program 

Interrupt  service  addresses  Subroutines 

Trap  addresses  Memory  addresses  for 
RAM  storage  input/output  devices 

Memory  stack  or  special  functions 

Still  other  ORIGIN  statements  may  allow  room  for  later  insertions,  place  tables  or  data  in 
memory,  or  assign  vacant  RAM  space  for  data  buffers.  Program  and  data  memory  in 
microcomputers  may  occupy  widely  scattered  addresses  to  simplify  the  hardware. 

Typical  ORIGIN  statements  are: 

ORG  RESET 
ORG  1000 
ORG  INT3 

Some  assemblers  assume  an  origin  of  zero  if  the  programmer  does  not  put  an  ORG 
statement  at  the  start  of  the  program.  The  convenience  is  slight;  we  recommend  the  in- 
clusion of  an  ORG  statement  to  avoid  confusion. 

THE  RESERVE  PSEUDO-OPERATION 

The  RESERVE  pseudo-operation  allows  the  programmer  to 
allocate  RAM  for  various  purposes  such  as  data  tables,  tem- 
porary storage,  indirect  addresses,  a  Stack,  etc. 


ALLOCATING 
RAM 
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Using  the  RESERVE  pseudo-operation,  you  assign  a  name  to  the  memory  area  and 
declare  the  number  of  locations  to  be  assigned.  Here  are  some  examples: 

NOKEY  RESERVE  1 

TEMP  RESERVE  50 

VOLTG  RESERVE  80 

BUFR  RESERVE  100 

You  can  use  the  RESERVE  pseudo-operation  to  reserve  memory  locations  In  program 
memory  or  in  data  memory;  however  the  nature  of  the  RESERVE  pseudo-operation  Is 
more  meaningful  when  applied  to  data  memory. 

In  reality,  all  the  RESERVE  pseudo-operation  does  is  increase  the  assembler's  Location 
Counter  by  the  amount  declared  in  the  operand  field.  The  assembler  does  not  actually 
produce  any  obiect  code. 

Note  the  following  features  of  RESERVE: 

1)  The  label  of  the  RESERVE  pseudo-operation  is  assigned  the  value  of  the  first  ad- 
dress reserved.  For  example,  the  sequence: 

ORG  3000 

BUFl       RESERVE  100 

BUF2       RESERVE  50 

VOLTS     RESERVE  5 

assigns  to  the  label  BUFl  the  value  3000,  to  BUF2  3100,  and  to  VOLTS  3150. 

2)  You  must  specify  the  number  of  locations  to  be  reserved.  There  is  no  default  case. 

3)  No  data  is  placed  into  the  reserved  locations.  Any  data  that,  by  chance,  may  be  in 
these  locations  will  be  left  there. 


Some  assemblers  allow  the  programmer  to  place  initial  INITIALIZING 
values  in  RAM.  We  strongly  recommend  that  you  do  not  RAM 
use  this  feature  —  it  assumes  that  the  program  (along  with 

the  initial  values)  will  be  loaded  from  an  external  device  (e.g.,  paper  tape  or  floppy  disk) 
each  time  it  is  run.  Most  microprocessor  programs,  on  the  other  hand,  reside  m  non- 
volatile ROM  and  start  when  power  comes  on.  The  RAM  in  such  situations  does  not  re- 
tain its  contents,  nor  is  it  reloaded.  Always  include  instructions  to  initialize  the  RAM  in 
your  program. 

LINKING  PSEUDO-OPERATIONS 


We  often  want  statements  in  one  program  or  subroutine  to     I  EXTERNAL 
use  names  that  are  defined  elsewhere.  Such  names  are  called     I  REFERENCES 
external  references;  a  special  linker  program  is  necessary  to  ac-  I— — — 
tually  fill  in  the  external  values  and  determine  if  any  names  are  undefined  or  doubly 
defined. 

The  pseudo-operation  EXTERNAL,  usually  abbreviated  EXT,  signifies  that  the 
name  is  defined  elsewhere. 

The  pseudo-operation  ENTRY,  usually  abbreviated  ENT,  signifies  that  the  name  is 
available  for  use  elsewhere,  i.e.,  it  is  defined  in  this  program. 

The  precise  way  in  which  linking  pseudo-operations  are  implemented  vanes  greatly 
from  assembler  to  assembler.  We  will  not  refer  to  such  pseudo-operations  again,  but 
they  are  very  useful  in  actual  applications. 

HOUSEKEEPING  PSEUDO-OPERATIONS 

There  are  various  housekeeping  pseudo-operations,  which  affect  the  operation  of 
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the  assembler  and  its  program  listing  rather  than  the  output  program  itself.  Com- 
mon housekeeping  pseudo-operations  include: 

1)  END.  which  marks  the  end  of  the  assembly  language  source  program. 

2)  LIST,  which  tells  the  assembler  to  print  the  source  program.  Some  assemblers  allow 
such  variations  as  NO  LIST  or  LIST  SYMBOL  TABLE  to  avoid  long,  repetitive  list- 
ings. 

3)  NAME  or  TITLE,  which  prints  a  name  at  the  top  of  each  page  of  the  listing. 

4)  PAGE  or  SPACE,  which  skips  to  the  next  page  or  next  line,  respectively,  and  im- 
proves the  appearance  of  the  listing,  making  it  easier  to  read. 

5)  PUNCH,  which  transfers  subsequent  object  code  to  the  paper  tape  punch.  This 
pseudo-operation  may  in  some  cases  be  the  default  option  and  therefore  unnecess- 
ary. 

LABELS  WITH  PSEUDO-OPERATIONS 

Users  often  wonder  if  or  when  they  can  assign  a  label  to  a  pseudo-operation. 
These  are  our  recommendations: 

1)  All  EQUATE  pseudo-operations  must  have  labels:  they  do  not  make  any  sense 
otherwise,  since  their  purpose  is  to  define  the  meaning  of  the  labels. 

2)  DATA  and  RESERVE  pseudo-operations  usually  have  labels.  The  label  identifies  the 
first  memory  location  used  or  assigned. 

3)  Other  pseudo-operations  should  not  have  labels.  Some  assemblers  allow  other 
pseudo-operations  to  have  labels,  but  the  meaning  of  the  labels  varies.  We  recom- 
mend that  you  avoid  this  practice. 

ADDRESSES  AND  THE  OPERAND  FIELD 

Most  assemblers  allow  the  programmer  a  lot  of  freedom  in  describing  the  con- 
tents of  the  Operand  Address  field.  But  remember,  the  assembler  has  built-in 
names  for  registers  and  instructions  and  may  have  other  built-in  names.   

Some  common  options  for  the  operand  field  are: 

1)  Decimal  numbers 

Most  assemblers  assume  all  numbers  to  be  decimal  unless  they 
are  marked  otherwise.  So: 

ADD  100 

means  "add  the  contents  of  memory  location  100  decimal  to  the  contents  of  the  Ac- 
cumulator" 

2)  Other  number  systems 

Most  assemblers  will  also  accept  binary,  octal,  or  hexadecimal  en- 
tries. But  you  must  identify  these  number  systems  in  some  way, 
e.g.,  by  preceding  or  following  the  number  with  an  identifying 
character  or  letter.  Here  are  some  common  identifiers: 

B  or  %  for  binary 

0,  Q,  C  or  @  for  octal  (we  avoid  0  because  of  the  confusion  with  zero). 
H  or  $  for  hexadecimal 

D  for  decimal.  D  may  be  omitted:  it  is  the  default  case. 


DECIMAL 
DATA  OR 
ADDRESSES 


OTHER 

NUMBER 

SYSTEMS 
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Assemblers  generally  require  hexadecimal  numbers  to  start  with  a  decimal  digit  (e.g., 
0A36  instead  of  A36)  in  order  to  distinguish  between  numbers  and  names  or  labels.  It  is 
good  practice  to  enter  numbers  in  the  base  in  which  their  meaning  is  the  clearest  — 
I.e.,  decimal  constants  in  decimal;  addresses  and  BCD  numbers  in  hexadecimal;  mask- 
ing patterns  or  bit  outputs  in  binary  if  they  are  short  and  in  hexadecimal  if  they  are  long. 

3)  Symbolic  names 

Names  can  appear  in  the  operand  field;  they  will  be  treated  as  the  data  that  they  repre- 
sent. But  remember.thera  is  a  difference  between  data  and  addresses.  The  se- 
quence: 

FIVE        EQU  5 

ADD  FIVE 

will  add  the  contents  of  memory  location  5  !not  necessarily  the  number  5)  to  the  con- 
tents of  the  Accumulator. 

4)  The  current  value  of  the  location  counter  (usually  referred  to  as  *  or  $). 

This  IS  useful  mainly  m  Jump  instructions:  for  example: 
JUMP  $-1-6 

causes  a  Jump  to  the  memory  location  six  words  beyond  the  word  that  contains  the 
first  byte  of  the  JUMP  instruction: 


Memory 


■  JUMP   $  +  6  code  stored  here 


•  Jump  here 


Most  microprocessors  have  many  two  and  three-word  instructions.  Thus,  you  will  have 
difficulty  determining  exactly  how  far  apart  two  assembly  language  statements  are. 
Therefore,  using  offsets  from  the  Location  Counter  frequently  results  in  errors  that  you 
can  avoid  if  you  use  labels. 

5)  Character  codes 

Most  assemblers  allow  text  to  be  entered  as  ASCII  strings.  Such 
stnngs  may  be  surrounded  either  with  single  or  double  quotation 
marks;  stnngs  may  also  use  a  beginning  or  ending  symbol  such  as 
A  or  C.  A  few  assemblers  also  permit  EBCDIC  strings. 

We  recommend  that  you  use  character  strings  for  all  text.  It  improves  the  clarity  and 
readability  of  the  program. 

6)  Combinations  of  1)  through  5)  with  arithmetic,  logical,  or  special  operators. 

Almost  all  assemblers  allow  simple  arithmetic  combinations  such  ARITHMETIC 
as  START-FI.  Some  assemblers  also  permit  multiplication,  divi-     AND  LOGICAL 
sion,  logical  functions,  shifts,  etc.  These  are  referred  to  as  expres-  EXPRESSIONS 
sions.  Note  that  the  assembler  evaluates  expressions  at  assembly 
time.  Even  though  an  expression  in  the  operand  field  may  involve  multiplication,  you 


ASCII 

CHARACTERS 
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mav  not  be  able  to  use  muitiplioation  in  the  logic  of  your  own  program  —  unless  you 
write  a  subroutine  for  that  specific  purpose. 

Assemblers  vary  in  what  expressions  they  accept  and  how  they  interpret  them.  Com- 
plex expressions  make  a  program  difficult  to  read  and  understand. 

We  have  made  some  recommendations  during  this  section  but  will  repeat  them  and 
add  others  here.  In  general,  the  user  should  emphasize  clarity  and  simplicity.  There 
is  no  payoff  for  being  an  expert  m  the  intricacies  of  assemblers  or  in  having  the  most 
complex  expression  on  the  block.  We  suggest  the  following  approach: 

1)  Use  the  clearest  number  system  or  character  code  for  data.  Masks  and  BCD  num- 
bers in  decimal,  ASCII  characters  in  octal,  or  ordinary  numerical  constants  in  hex- 
adecimal serve  no  purpose  and  therefore  should  not  be  used. 

2)  Remember  to  distinguish  data  and  addresses. 

3)  Don't  use  offsets  from  the  Location  Counter. 

4)  Keep  expressions  simple  and  obvious.  Don't  rely  on  obscure  features  of  the  assem- 
bler. 

CONDITIONAL  ASSEMBLY 

Some  assemblers  allow  you  to  include  or  exclude  parts  of  the  source  program,  de- 
pending on  conditions  existing  at  assembly  time.  This  is  called  conditional  assem- 
bly; It  gives  the  assembler  some  of  the  flexibility  of  a  compiler.  Most  microcomputer 
assemblers  have  limited  capabilities  for  conditional  assembly.  A  usual  form  is: 

IF  COND 

.CONDITIONAL  PROGRAM 
ENDIF 

If  the  expression  COND  is  true  at  assembly  time,  the  instructions  between  IF  and  ENDIF 
(two  pseudo-operations)  are  included  in  the  program. 

Typical  uses  of  conditional  assembly  are: 

1)  To  include  or  exclude  extra  variables. 

2)  To  place  diagnostics  or  special  conditions  in  test  runs. 

3)  To  allow  data  of  various  bit  lengths. 

4)  To  create  specialized  versions  of  a  common  program. 

Unfortunately,  conditional  assembly  tends  to  clutter  programs  and  make  them  difficult 
to  read.  Use  conditional  assembly  only  if  it  is  necessary. 

MACROS 


You  will  often  find  that  particular  sequences  of  instructions  oc- 
cur many  times  in  a  source  program.  Repeated  instruction  se- 
quences mav  reflect  the  needs  of  your  program  logic,  or  they 
may  be  compensating  for  deficiencies  in  your  microprocessor's 
instruction  set.  You  can  avoid  repeatedly  writing  out  the  same  instruction  sequence  by 
using  a  macro. 

Macros  allow  you  to  assign  a  name  to  an  instruction  sequence.  You  then  use  the 
macro  name  in  your  source  program  instead  of  the  repeated  instruction  sequence. 


DEFINING  A 
SEQUENCE  OF 
INSTRUCTIONS 
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The  assembler  will  replace  the  macro  name  with  the  appropriate  sequence  of  in- 
structions. This  may  be  illustrated  as  follows: 


Source  Program 


Object  Program 


MAC1 


MACRO 
instruction  M 
instruction  N12 
instruction  M3 

ENDM 


instruction  P1 
instruction  P2 
instruction  P3 


13  ) 


{macro  definition) 


(end  of  macro  definiltoni 


(mam  program) 


MACl 


MAC1 


instruction  P8 
instruction  P9 


MACl 


instruction  P10  ! 
instruction  P11  ' 


instruction  PI 
instruction  P2 
instruction  P3 
instruction  Ml 
instruction  M2 
instruction  M3 

instruction  P4 
instruction  P5 
instaiction  P6 
instruction  P7 
instruction  Ml 
instruction  M2 
instruction  M3 

instruction  P8 
instruction  P9 

instruction  Ml 
instruction  M2 
instruction  M3 

instruction  PIO 
instruction  P1 1 


Macros  are  not  the  same  as  subroutines.  A  subroutine  occurs  once  in  a  program,  and 


macro  is  expanded  to  an  actual  in- 
thus  a  macro  does  not  cause  any 


ADVANTAGES 
OF  MACROS 


program  execution  branches  to  the  subroutine.  A 
struction  sequence  each  time  the  macro  occurs; 
branching. 

Macros  have  the  following  advantages: 

1)  Shorter  source  programs. 

2)  Better  program  documentation. 

3)  Use  of  debugged  instruction  sequences  —  once  the  macro  has  been  debugged, 
you  are  sure  of  an  error-free  instruction  sequence  every  time  you  use  the  macro. 

4)  Easier  changes.  Change  the  macro  definition  and  the  assembler  makes  the  change 
for  you  eyery  time  the  macro  is  used. 

5)  Inclusion  of  commands,  keywords,  or  other  computer  Instructions  in  the  basic  in- 
struction set.  You  use  the  macro  as  an  extension  of  your  instruction  set. 

The  disadvantages  of  macros  are: 

1)    Repetition  of  the  same  instruction  sequences  since  the 
macro  is  expanded  every  time  it  is  used. 


DISADVANTAGES 
OF  MACROS 
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2)  A  single  macro  may  create  a  lot  of  instructions. 

3)  Lack  of  standardization  that  nnav  make  the  program  difficult  to  read  and  unders- 
tand. 

4)  Possible  effects  on  registers  and  flags  that  may  not  be  clearly  stated. 

One  problem  is  that  variables  used  in  a  macro  are  known  only        LOCAL  OR 
within  it  (i.e..  they  are  local  rather  than  global).  This  can  often  GLOBAL 
create  a  great  deal  of  confusion  without  any  gain  in  return.  You  VARIABLES 

should  be  aware  of  this  problem  when  using  macros.  «,^— — i 


COMMENTS 

All  assemblers  allow  you  to  place  comments  in  a  source  program.  Comments  have 
no  effect  on  the  object  code,  but  they  help  you  to  read,  understand,  and  document 
the  program.  Good  commenting  is  an  essential  part  of  writing  assembly  language 
programs;  without  comments,  programs  are  very  difficult  to  understand. 

We  will  discuss  commenting  along  with  documentation  in  a 
later  chapter,  but  here  are  some  guidelines: 


COMMENTING 
TECHNIQUES 


11    Use  comments  to  tell  what  the  program  is  doing,  not  what  instructions  do. 

Comments  should  say  things  like  "IS  TEMPERATURE  ABOVE  LIMIT?",  "LINE  FEED 
TO  TTY".  or  "EXAMINE  LOAD  SWITCH". 

Comments  should  not  say  things  like  "ADD  1  TO  ACCUMULATOR"  "JUMP  TO 
START",  or  "LOOK  AT  CARRY".  You  should  describe  how  the  program  is  affecting 
the  system:  internal  effects  on  the  CPU  are  seldom  of  any  interest. 

2i  Keep  comments  brief  and  to  the  point.  Details  should  be  available  elsewhere  in  the 
documentation. 

3)  Comment  all  key  points. 

4)  Do  not  comment  standard  instructions  or  sequences  that  change  counters  and 
pointers;  pay  special  attention  to  instructions  that  may  not  have  an  obvious  mean- 
ing. 

5)  Do  not  use  obscure  abbreviations. 

6)  Make  the  comments  neat  and  readable. 

7)  Comment  all  definitions,  describing  their  purposes.  Also  mark  all  tables  and  data 
storage  areas. 

8)  Comment  sections  of  the  program  as  well  as  individual  instructions. 

9)  Be  consistent  in  your  terminology.  You  can  (should)  be  repetitive;  you  do  not  need 
to  consult  a  thesaurus. 

10)  Leave  yourself  notes  at  points  which  you  find  confusing,  e.g.,  "REMEMBER  CAR- 
RY WAS  SET  BY  LAST  INSTRUCTION"  You  may  drop  these  in  the  final  documen- 
tation. 

A  well-commented  program  is  easy  to  work  with.  You  will  recover  the  time  spent  in 
commenting  many  times  over.  We  will  try  to  show  good  commenting  style  in  the  pro- 
gramming examples,  although  we  often  over-comment  for  instructional  purposes. 
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TYPES  OF  ASSEMBLERS 


Although  all  assemblers  perform  the  same  tasks,  their  implementations  vary 
greatly.  We  will  not  try  to  describe  all  the  existing  types  of  assemblers;  we  will 
merely  define  the  terms  and  indicate  some  of  the  choices. 

A  cross-assembler  is  an  assembler  that  runs  on  a  computer 
other  than  the  one  for  which  it  assembles  object  programs. 


CROSS- 
ASSEMBLER 


RESIDENT 
ASSEMBLER 


The  computer  on  which  the  cross-assembler  runs  is  typicallv  a 
large  computer  with  extensive  software  support  and  fast  peripherals  —  such  as  an  IBM 
360  or  370,  a  Univac  1 1 08,  or  a  Burroughs  6700.  The  computer  for  which  the  cross-as- 
sembler assembles  programs  is  tvpically  a  microcomputer  like  the  Z80  or  MC6800. 
Most  cross-assemblers  are  written  in  FORTRAN  so  that  they  are  portable. 

A  self-assembler  or  resident  assembler  is  an  assembler  that  runs 
on  the  computer  for  which  it  assembles  programs.  The  self-assem- 
bler will  require  some  memory  and  peripherals,  and  it  may  run 
quite  slowly. 

A  macroassembler  is  an  assembler  that  allows  you  to  define 
sequences  of  instructions  as  macros. 

A  microassembler  is  an  assembler  used  to  write  the 
microprograms  that  define  the  instruction  set  of  a  computer. 
Microprogramming  has  nothing  specifically  to  do  with 
microcomputers. 


MACRO- 
ASSEMBLER 


MICRO- 
ASSEMBLER 


META- 
ASSEMBLER 


A  meta-assembler  is  an  assembler  that  can  handle  many 
different  instruction  sets.  The  user  must  define  the  particular  in- 
struction set  being  used. 

A  one-pass  assembler  is  an  assembler  that  goes  through  the 
assembly  language  program  only  once.  Such  an  assembler  must 
have  some  way  of  resolving  forward  references,  e.g.,  Jump  in- 
structions which  use  labels  that  appear  later  in  the  source  program,  i.e.,  that  have  not 
yet  been  defined. 


ONE-PASS 
ASSEMBLER 


A  two-pass  assembler  is  an  assembler  that  goes  through  the  TWO-PASS 
assembly  language  source  program  twice.  The  first  time  the  ASSEMBLER 
assembler  simply  collects  and  defines  all  the  symbols;  the  i— — — — — 
second  time  it  replaces  the  references  with  the  actual  definitions.  A  two-pass  as- 
sembler solves  most  of  the  forward  reference  problems.  However,  macro  expan- 
sion and  conditional  assembly  can  cause  problems.  On  some  large  machines  seven 
or  more  passes  are  needed  to  insure  that  all  forward  references  are  resolvable.  A 
two-pass  assembler  may  be  quite  slow  if  no  backup  storage  {like  a  floppy  disk)  is 
available;  then  the  assembler  must  physically  read  the  program  twice  from  a  slow 
input  medium  (like  a  teletypewriter  paper  tape  reader).  Most  microprocessor- 
based  assemblers  require  two  passes. 


ERRORS 

Assemblers  normally  provide  error  messages,  often  consisting  of  a  single  coded 
letter.  Some  typical  errors  are: 

1)  Undefined  name  (often  a  misspelling  or  an  omitted  definition). 

2)  Illegal  character  (e.g.,  a  2  in  a  binary  number). 
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3)  Illegal  format  (wrong  delimiter  or  incorrect  operands). 

4)  Invalid  expression  (e.g..  two  operators  in  a  row). 

5)  Illegal  value  (usually  too  large). 

6)  Missing  operand. 

7)  Double  definition  (i.e..  two  different  values  assigned  to  one  name). 

8)  Illegal  label  (e.g..  a  label  on  a  pseudo-operation  that  cannot  have  one). 

9)  Missing  label. 

10)    Undefined  operation  code. 

In  interpreting  assembler  errors,  vou  must  remember  that  the  assembler  may  get  off  on 
the  wrong  track  if  it  finds  a  stray  letter,  an  extra  space,  or  incorrect  punctuation.  Many 
assemblers  will  then  proceed  to  misinterpret  the  succeeding  instructions  and  produce 
meaningless  error  messages.  Always  look  at  the  first  error  very  carefully;  subsequent 
ones  may  depend  on  it.  Caution  and  consistent  adherence  to  standard  formats  will 
eliminate  many  annoying  mistakes. 


LOADERS 


BOOTSTRAP 
LOADER 


The  loader  is  the  program  which  actually  takes  the  output  (obiect  code)  from  the  as 
sembler  and  places  it  in  memory.  Loaders  range  from  the  very  simple  to  the  very  com 
plex.  We  will  describe  a  few  different  types. 

A  bootstrap  loader  is  a  program  that  uses  its  own  first  few  in- 
structions to  load  the  rest  of  itself  or  another  loader  program 
into  memory.  The  bootstrap  loader  may  be  m  ROM,  or  you  may 
have  to  enter  it  into  the  computer  memory  using  front  panel  switches.  The  assembler 
may  place  a  bootstrap  loader  at  the  start  of  the  obiect  program  that  it  produces, 

A  relocating  loader  can  load  programs  anywhere  in  memory.  It 

typically  loads  each  program  into  the  memory  space  immediately 
following  that  used  by  the  previous  program.  The  programs, 
however,  must  themselves  be  capable  of  being  moved  around  in  this  way,  i.e..  they 
must  be  relocatable.  .An  absolute  loader,  in  contrast,  will  always  place  the  programs  in 
the  same  area  of  memory.   


RELOCATING 
LOADER 


LINKING 
LOADERS 


A  linking  loader  loads  programs  and  subroutines  that  have 
been  separately  assembled;  it  resolves  external  references  — 

that  is,  an  instruction  in  one  module  that  refers  to  a  label  in 
another  module.  Object  programs  loaded  by  a  linking  loader  must  be  created  by  an  as- 
sembler that  permits  and  marks  external  references. 

An  alternative  approach  is  to  separate  the  linking  and  loading 
functions  and  have  the  linking  performed  by  a  program  called  a 
link  editor. 


LINK 
EDITOR 
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Chapter  3 
THE  Z80  ASSEMBLY  LANGUAGE 
INSTRUCTION  SET 


We  are  now  ready  to  start  writing  assembly  language  programs.  We  begin  in  this 
chapter  by  defining  the  individual  instructions  of  the  Z80  assembly  language  in- 
struction set,  plus  the  syntax  rules  of  the  Zilog  assembler. 

We  do  not  discuss  any  aspects  of  microcomputer  hardware,  signals,  interfaces,  or 
CPU  architecture  in  this  book.  This  information  is  described  in  detail  in  An  Introduction 
to  Microcomputers:  Volume  2 — Some  Real  Microprocessors  and  Volume  3  — Some 
Real  Support  Devices,  while  Z80  Programming  for  Logic  Design  discusses  assembly 
language  as  an  extension  of  digital  logic.  In  this  book,  we  look  at  programming  tech- 
niques from  the  assembly  language  programmer's  viewpoint,  where  pins  and  sig- 
nals are  irrelevant  and  there  are  no  important  differences  between  a  minicom- 
puter and  a  microcomputer. 

Interrupts,  direct  memory  access,  and  the  Stack  architecture  for  the  Z80  will  be  de- 
scribed in  later  chapters  of  this  book,  in  conjunction  with  assembly  language  program- 
ming discussions  of  the  same  subjects. 

This  chapter  contains  a  detailed  definition  of  each  assembly  language  instruction. 
These  definitions  are  identical  to  those  found  m  Chapter  6  of  Z80  Programming  for 
Logic  Design. 

The  detailed  description  of  individual  instructions  is  preceded  by  a  general  discussion 
of  the  Z80  instruction  set  that  divides  instructions  into  those  which  are  commonly 
used,  infrequently  used,  and  rarely  used.  If  you  are  an  experienced  assembly  language 
programmer,  this  categorization  is  not  particularly  important  —  and.  depending  on  your 
own  programming  prejudices,  it  may  not  even  be  accurate.  If  you  are  a  novice  assembly 
language  programmer,  we  recommend  that  you  begin  by  writing  programs  using  only 
instructions  in  the  "commonly  used"  category.  Once  you  have  mastered  the  concepts 
of  assembly  language  programming,  you  may  examine  other  instructions  and  use  them 
where  appropriate. 
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CPU  REGISTERS  AND  STATUS  FLAGS 

The  CPU  registers  and  status  flags  for  the  280  may  be  illustrated  as  follows: 
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The  Accumulator  is  the  primary  source  and  destination  for  one-operand  and  two- 
operand  instructions.  For  example,  the  shortest  and  fastest  data  transfers  between  the 
CPU  and  I/O  devices  are  performed  through  the  Accumulator.  In  addition,  more  Memo- 
ry Reference  instructions  move  data  between  the  Accumulator  and  memory  than  bet- 
ween any  other  register  and  memory.  All  8-bit  arithmetic  and  Boolean  instructions  take 
one  of  the  operands  from  the  Accumulator  and  return  the  result  to  the  .Accumulator.  An 
instruction  must  therefore  load  the  Accumulator  before  the  Z80  can  perform  any  8- 
bit  arithmetic  or  Boolean  operations. 

The  B,  0.  D,  E,  H,  and  L  registers  are  all  secondary  registers.  Data  stored  in  any  of 
these  SIX  registers  may  be  accessed  with  equal  ease:  such  data  can  be  moved  to  any 
other  register  or  can  be  used  as  the  second  operand  in  two-operand  instructions. 

There  are,  however,  some  important  differences  in  the  functions  of  Registers  B,  C,  D.  E, 
H,  and  L. 

Registers  H  and  L  are  the  primary  Data  Pointer  for  the  Z80.  That  is  to  say,  you  will 
normally  use  these  two  registers  to  hold  the  16-bit  memory  address  of  data  being  ac- 
cessed. Data  may  be  transferred  between  anv  registers  and  the  memory  location  ad- 
dressed by  H  and  L.  Since  HL  is  the  primary  Data  Pointer,  it  often  takes  fewer  bytes  of 
obieot  code  and  less  instruction  cycles  to  perform  operations  with  it.  TheZSO  program- 
mer should  try  to  address  data  memory  via  Registers  H  and  L  whenever  possible. 

Within  your  program  logic,  always  reserve  Registers  H  and  L  to  hold  a  data  memo- 
ry address. 
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Registers  B,  C,  D,  and  E  provide  secondary  data  storage;  frequently,  the  second 
operand  for  two-operand  instructions  is  stored  in  one  of  these  four  registers.  (The  first 
operand  is  stored  in  the  Accun^ulator.  which  is  also  the  destination  for  the  result.) 

There  are  a  limited  number  of  instructions  that  treat  Registers  B  and  C,  or  D  and  E, 
as  16-bit  Data  Pointers.  But  these  instructions  move  data  between  memory  and  the 
Accumulator  only. 

In  your  program  logic  you  should  normally  use  Registers  B,  C,  D,  and  E  as  tempor- 
ary storage  for  data  or  addresses. 

Registers  IX  and  lY  are  index  registers.  They  provide  a  limited  indexing  capability  of 
the  type  described  in  An  Introduction  to  Microcomputers:  Volume  1  for  short  instruc- 
tions. 

The  alternate  registers  F',  A',  B',  C  D',  E',  H',  and  L'  provide  a  duplicate  set  of 
general  purpose  registers.  Just  two  single-byte  Exchange  instructions  select  and 
deselect  all  alternate  registers;  one  instruction  exchanges  AF  and  the  alternate  AF' 
as  a  register  pair,  and  one  instruction  exchanges  BC.  DE,  and  HL  with  the  alternate  BC, 
DE'.  and  HL'.  Once  selected,  all  subsequent  register  operations  are  performed  on  the  ac- 
tive set  until  the  next  exchange  selects  the  inactive  set.  The  alternate  registers  can  be 
reserved  for  use  when  a  fast  interrupt  response  is  required.  Or,  thev  may  be  used  in 
any  desired  way  by  the  programmer. 

There  are  a  number  of  instructions  that  handle  1 6  bits  of  data  at  a  time.  These  in- 
structions refer  to  pairs  of  CPU  registers  as  follows: 


F 

and 

A 

B 

and 

C 

D 

and 

E 

H 

and 

L 

F' 

and 

A' 

B' 

and 

C 

D' 

and 

E' 

H' 

and 

f 

High- 

Low- 

order 

order 

byte 

byte 

The  combination  of  the  Accumulator  and  flags,  treated  as  a  16-bit  unit,  is  used  only  for 
Stack  operations  and  alternate  register  switches.  Arithmetic  operations  access  B  and  C. 
D  and  E,  or  H  and  L  as  16-bit  data  units. 

The  Carry  status  flag  holds  carries  out  of  the  most  significant  bit  in  any  arithmetic 
operation.  The  Carry  flag  is  also  included  in  Shift  instructions:  it  is  reset  by  Boolean  in- 
structions. 

The  Subtract  flag  is  designed  for  internal  use  during  decimal  adjust  operations.  This 
flag  is  set  to  1  for  all  Subtract  instructions  and  reset  to  0  for  all  Add  instructions. 

The  Parity/Overflow  flag  is  a  multiple  use  flag,  depending  on  the  operation  being 
performed.  For  arithmetic  operations,  it  is  an  overflow  flag.  For  input,  rotate,  and 
Boolean  operations,  it  is  a  parity  flag,  with  1  =  even  parity  and  0  =  odd  parity.  Dur- 
ing block  transfer  and  search  operations,  it  remains  set  until  the  byte  counter  decre- 
ments to  zero:  then  it  is  reset  to  zero.  It  is  also  set  to  the  current  state  of  the  interrupt 
enable  flip-flop  {IFF2)  when  a  LD  A.I  or  LD  A,R  instruction  is  executed. 

The  Zero  flag  is  set  to  1  when  any  arithmetic  or  Boolean  operation  generates  a 
zero  result.  The  Zero  status  is  set  to  0  when  such  an  operation  generates  a  non- 
zero result. 
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The  Sign  status  flag  acquires  the  value  of  the  most  significant  bit  of  the  result 
following  the  execution  of  any  arithmetic  or  Boolean  instruction. 

The  Auxiliary  Carry  status  flag  holds  any  carry  from  bit  3  to  4  resulting  from  the 
execution  of  an  arithmetic  instruction.  The  purpose  of  this  status  flag  is  to  simplify 
Binary-Coded-Decima!  (BCD)  operations;  this  is  the  standard  use  of  an  Auxiliary  Carry 
status  flag  as  described  in  An  Introduction  to  Microcomputers:  Volume  1.  Chapter  3. 

All  of  the  above  status  flags  keep  their  current  value  until  an  instruction  that  modifies 
them  IS  executed.  Merely  changing  the  value  of  the  Accumulator  will  not  necessarily 
change  the  value  of  the  status  flags.  For  example,  if  the  Zero  flag  is  set,  and  a  load  im- 
mediate to  the  Accumulator  is  executed,  that  causes  the  Accumulator  to  acquire  a  non- 
zero value:  the  value  of  the  Zero  flag  remains  unchanged. 

The  1 6-bit  Stack  Pointer  allows  you  to  implement  a  Stack  anywhere  in  addressa- 
ble memory.  The  size  of  the  Stack  is  limited  only  by  the  amount  of  addressable  memory 
present.  In  reality  you  will  rarely  use  more  than  256  bytes  of  memory  for  your  Stack. 
You  should  use  the  Stack  for  accessing  subroutines  and  processing  interrupts.  Do  not 
use  the  Stack  to  pass  parameters  to  subroutines.  This  is  not  very  efficient  within  the 
limitations  of  the  Z80  instruction  set.  The  Z80  Stack  is  started  at  its  highest  address.  A 
Push  decrements  the  Stack  Pointer  contents:  a  Pop  increments  the  Stack  Pointer  con- 
tents. 

The  Interrupt  Vector  register  and  the  Refresh  register  are  special-purpose 
registers  not  normally  used  by  the  programmer. 

The  Interrupt  Vector  register  is  used  to  store  the  page  address  of  an  interrupt  response 
routine;  the  location  on  the  page  is  provided  by  the  interrupting  device.  This  scheme 
allows  the  address  of  the  interrupt  response  routine  to  be  changed  while  still  providing 
a  very  fast  response  time  for  the  interrupting  device. 

The  Refresh  register  contains  a  memory  refresh  counter  in  the  low-order  seven  bits. 
This  counter  is  incremented  automatically  after  each  instruction  fetch  and  provides  the 
next  refresh  address  for  dynamic  memories.  The  high-order  bit  of  the  Refresh  register 
will  remain  set  or  reset,  depending  on  how  it  was  loaded  at  the  last  LD  R.A  instruction. 

Z80  MEMORY  ADDRESSING  MODES 

The  Z80  provides  extensive  addressing  modes.  These  include: 

•  Implied 

•  Implied  Block  Transfer  with  Auto-increment/Decrement 

■  Implied  Stack 

■  Indexed 

■  Direct 

•  Program  Relative 

•  Base  Page 

•  Register  Indirect 

■  Immediate 
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Implied 

In  implied  memory  addressing,  the  H  and  L  registers  hold  the  address  of  the 
memory  location  being  accessed.  Data  may  be  moved  between  the  identified  memo- 
ry location  and  any  one  of  the  seven  CPU  registers  A.  B,  C,  D,  E.  H,  or  L.  For  example,  the 
instruction 

LD  C.(HU 

loads  the  C  register  with  the  contents  of  the  memory  location  currently  pointed  to  by 
HL.  This  IS  illustrated  as  follows: 
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A  limited  number  of  instructions  use  Registers  B  and  C  or  D  and  E  as  the  Data 
Pointer.  These  instructions  nnove  data  between  the  Accumulator  and  the  memory  loca- 
tion addressed  by  Registers  B  and  C  or  Registers  D  and  E.  The  instruction 

LD  (BC),A 

stores  the  contents  of  A  into  the  memory  location  currently  addressed  by  Register  Pair 
SC.  This  is  illustrated  as  follows: 
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implied  Bioci<  Transfer  With  Auto-Increment/Decrement 

Block  Transfer  and  Search  instructions  operate  on  a  bloci<  of  data  whose  size  is 
set  by  the  programmer  as  the  contents  of  the  BC  register  pair,  in  this  form  of  ad- 
dressing, a  byte  of  data  is  moved  from  the  memory  location  addressed  by  HL  to 
the  memory  location  addressed  by  DE;  then  HL  and  DE  are  incremented  and  BC  is 
decremented.  Data  transfer  continues  until  BC  reaches  zero,  at  which  point  the  in- 
struction is  terminated.  Variations  include  allowing  other  instructions  to  follow 
each  data  transfer,  with  the  programmer  supplying  the  loopback;  auto-decrement- 
ing HL  and  DE  instead  of  auto-incrementing;  and  a  complementary  set  of  Block 
Search  instructions  that  compare  the  memory  byte  addressed  by  HL  with  the  con- 
tents of  the  A  register,  setting  a  flag  if  a  match  is  found. 

The  Load,  Increment,  and  Repeat  instruction 


LDIR 


IS  illustrated  as  follows: 
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A  similar  group  of  Input/Output  instructions  is  provided,  allowing  a  block  of  data 
to  be  input  or  output  between  memory  and  an  I/O  device.  The  I/O  port  number  is 
taken  as  the  contents  of  the  C  register,  with  the  single  B  register  used  as  the  byte 
counter.  Memory  is  addressed  by  HL. 
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Implied  Stack 

Since  the  Stack  is  part  of  Read/Write  memory,  we  must  consider  Stack  instructions  as 
Memory  Reference  instructions.  Push  and  Pop  instructions  move  two  bytes  of  data 
between  a  register  pair  and  the  addressed  Stacl<  Pointer  location,  i.e..  current  top- 
of-stack.  The  Z80  Stack  address  is  decremented  with  each  Push  and  incremented  with 
each  Pop.  The  instruction 


PUSH  DE 


is  illustrated  as  follows: 
S   Z  Ac  P/0  N  C 
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The  Z80  also  has  instructions  that  exchange  the  two  top-of-stack  bytes  with  a 
16-bit  register  —  HL  or  one  of  the  two  index  registers.  The  instruction 

EX  (SP),HL 

IS  illustrated  as  follows: 
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Indexed 

The  Z80  has  two  16-bit  index  registers,  called  IX  and  lY.  They  may  be  used  In- 
terchangeably. All  memory  reference  operations  for  which  (HL)  can  be  specified  can 
alternatively  be  specified  as  an  indexed  operation.  The  difference  between  implied  ad- 
dressing using  HL  and  indexed  addressing  using  IX  and  lY  is  that  the  index  operand 
includes  a  displacement  value  that  is  added  to  the  index  address.  In  the  instruction 

ADD  A.(IX+40H) 

the  memory  address  is  the  sum  of  the  contents  of  the  IX  register  and  40 .j  g.  This  may  be 
illustrated  as  follows: 
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Direct 

Direct  addressing  can  be  used  to  load  tlie  Accumulator  with  any  8-bit  value  from 
memory,  load  BC,  DE,  HL,  SP,  iX,  or  lY  with  any  1 6-bit  memory  value,  and  jump  or 
call  subroutines  direct  at  any  memory  location.  The  16-blt  direct  address  is  stored  in 
the  last  two  bytes  of  the  instruction,  in  low-byte  high-byte  order  (this  is  the  reverse  of 
the  standard  high-low  scheme). 

The  instruction 

LD  A.(NETX) 

loads  the  A  register  with  the  contents  of  the  memory  location  addressed  by  the  label 
NETX.  The  instruction 

LD  HLilFFH) 

loads  the  L  register  with  the  contents  of  memory  location  OlFF^g  and  the  H  register 
"  the  contents  of  nr      "  '  ^'^^n  .    ,    ...  ... 

S    Z  Ac  P/0  N  C 


with  the  contents  of  memory  location  0200 .jg.  This  may  be  illustrated  as  follows: 


B.C 
O.E 
H.L 
SP 
PC 
IX 
lY 
! 

R 


W 


Data 
Memory 


01FF 
0200 


Program 
Memory 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  3 


LD  HL.(IFFH) 
5    4    3  2 


Load  HL  Direct  mstruction 
Direct  address  -  low  byte 
Direct  address  -  High  byte 


The  direct  Jump  instructions  provide  jumps  and  jumps-to-subroutines,  both  un- 
conditional and  conditional.  These  are  all  3-byte  instructions,  with  the  direct  address 
stored  in  the  second  and  third  bytes  of  the  instruction,  as  shown  above  for  Load  Direct. 

There  are  three  additional  addressing  modes  used  by  Z80  Branch  instruc- 
tions: program  relative,  base  page,  and  register  indirect.  In  general,  they  are  shorter 
and/or  faster  than  direct  jumps  but  may  have  more  limited  addressing  capabilities. 
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Program  Relative 

Jump  Relative  instructions  provide  program  relative  addressing  in  the  range  -126, 
+129  bytes  from  the  first  byte  of  the  Program  Relative  instruction.  These  instructions 
are  all  2-byte  instructions,  with  the  signed  displacement  value  stored  in  the  second 
byte  of  the  instruction.  There  are  unconditional  and  conditional  relative  jumps,  as 
well  as  a  Decrement  and  Jump  If  Not  Zero  instruction  (DJNZ)  that  facilitates  loop 
control. 

Given  the  instruction 

JR  SRCH 

assume  that  SRCH  is  a  label  addressing  a  location  5A^g  bytes  up  in  memory  from  the 
JR  op-code  byte.  The  operation  may  be  illustrated  as  follows: 


S    Z  Ac  P/0  N 

-Tm~ 


A 

B.cl 

D.E 

H.lI 

spI 

PC  I 
IX  I 
lY 


C 
□ 


Data 
Memory 


Program 


r 

Memory 

IB 

5A 

mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


0 

0 

0 

t 

1 

0 

0 

0 

0 

1 

0 

1 

1 

0 

1 

0 

Jump  Relative  tnstructton 
Displacement 
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Base  Page 

The  Z80  has  a  modified  base  page  addressing  mode  for  the  Restart  instruction.  This  is 
a  special  Call  instruction  that  allows  a  single-byte  instruction  to  jump  to  one  of 
eight  subroutines  located  at  specific  points  in  lower  core.  The  effective  address  is 
calculated  from  a  3-bit  code  stored  in  the  instruction,  as  follows: 

Lower  Core  Address    3-Blt  Code 


OOH 

000 

08H 

001 

10H 

010 

18H 

Oil 

20H 

100 

28H 

101 

30H 

110 

38H 

111 

The  decoded  address  value  is  loaded  into  the  low-order  byte  of  the  Program  Counter; 
the  high-order  byte  of  the  Program  Counter  is  set  to  zero.  For  example,  the  instruction 

RST  OOH 

is  illustrated  as  follows: 


S  Z  Ac  P/0  N  C  Data 


ttimmm  +  2 
nfinftitim  +  3 


RST  OOH 


Restart  instruction 
Address  code 
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Register  Indirect 

In  standard  indirect  addressing,  a  memory  location  contains  the  effective  address,  and 
the  instruction  specifies  the  address  of  the  memory  location  containing  the  effective 
address.  In  register  indirect  addressing,  a  register  contains  the  effective  address,  and 
the  instruction  specifies  which  of  the  registers  contains  the  effective  address.  Note  that 
for  a  Load,  for  instance,  this  is  just  another  way  of  describing  implied  addressing. 
However,  the  Z80  has  Jump  instructions  that  allow  a  jump  to  the  memory  location 
whose  address  Is  contained  In  the  specified  register.  This  is  a  form  of  indirect  ad- 
dressing, and  is  described  separately  because,  while  most  microcomputers  have  im- 
plied addressing,  very  few  have  register  indirect  jumps. 

The  instruction 

JP  {HU 

directs  that  a  jump  is  to  be  taken  to  the  memory  location  whose  address  is  contained  in 
HL.  This  may  be  illustrated  as  follows: 


S   Z  Aq  P/0  n  c 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


PP 

mmmm 

Data 
Memory 


Program 
Memory 

E9 


mmmm  -f  1 
mmmm  +  2 
mmmm  3 


jj  Jump  via  HL 
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Immediate 

Some  texts  identify  Immediate  instructions  as  Memory  Reference  instructions.  An  Im- 
mediate instruction  is  a  2-,  3-,  or  4-bvte  instruction  in  which  the  last  one  or  two  bytes 
hold  fixed  data  that  is  loaded  into  a  register  or  memory  location.  The  Z80  provides  Im- 
mediate instructions  to: 

•  load  8-bit  data  into  any  of  the  8-bit  registers, 

•  load  16-bit  data  into  any  of  the  register  pairs  or  16-bit  registers, 

•  store  8-bit  data  into  any  memory  location  using  implied  or  indexed  addressing, 

•  perform  arithmetic  and  logical  operations  using  the  Accumulator  and  8-bit  im- 
mediate data. 

The  instruction 

LD  BCOBCH 

loads  the  immediate  data  value  BCig  into  Register  Pair  BC.  This  may  be  illustrated  as 
follows: 


S    Z  Ac  P/0  N  C 

^Lii  l„LiJ 


A 

B,C 
D.E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


Data 
Memory 


Program 
Memory 


fTimmm 
mmmm  + 1 
mmmm  +  2 
mmmm  -t-  3 


LD    BC,  OBCH 
7     6    5    4     3     2    1  0 


Load  Immediate  to  Register  Pair 
Register  Pair  BC 

Immediate  data  -  low-order  byte 
Immediate  data  -  higii-order  byte 
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Table  3-1.  Frequently  Used  Instructions  of  the  Z80 


Instruction  Code 

Meaning 

ADC 

/\ 

Add  with  Carrv  to  Accumulator 

ADD 

Add 

AND 

Logical  AND 

CALL 

aHHr 

ctUUI 

Call  Subroutine 

CALL 

rnnd  artdr 

Call  Conditional 

CP 

Compare 

DEC 

Decrement 

DJNZ 

Decrement  and  Jump  If  Not  Zero 

IN 

Input 

INC 

Increment 

JR 

Jump  Relative 

JR 

pnnH  flHHr 

Jump  Relative  Conditional 

LD 

ran  IHLI 

Load  Register 

1  n 

A  (aHrIri 
\dUU[; 

Load  Accumulator  Direct 

LD 

Load  Immediate 

LD 

(HL)  rPQ 

Store  Register 

LD 

(arirlri  A 
\aUUI  /('^ 

Store  Accumulator  Direct 

LD 

ric:t  c;rr' 

Move  Register-to-Register 

OUT 

Output 

POP 

Pop  from  Stack 

PUSH 

Push  to  Stacl< 

RET 

Return  from  Subroutine 

RET 

cond 

Return  Conditional 

RLA 

Rotate  Accumulator  Left  Through  Carry 

RRA 

Rotate  Accumulator  Right  Through  Carry 

SLA 

Shift  Left  Arithmetic 

SRL 

Shift  Right  Logical 

SUB 

Subtract 
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Table  3-2.  Occasionally  Used  instructions  of  the  Z80 


Instruction  Code 

Meaning 

BIT 

Test  Bit 

CPD.  CPDR 

CofTtpars,  Decrement.  (Repeat) 

CP),  CPIR 

Compare,  Increment.  (Repeat) 

CPL 

Complement  Accumulator 

DAA 

Decimal  Adjust  Accumulator 

Dl 

Disable  Interrupts 

El 

Enable  Interrupts 

EX 

Exchange 

HALT 

Halt 

IND,  INDR 

Input,  Decrement,  (Repeat) 

INI.  INIR 

Input,  Increment.  (Repeat) 

JP 

addr 

Jump 

JP 

cond.addr 

Jump  Conditional 

LD 

A,(BC)  or  (DE) 

Load  -Accumulator  Secondarv 

LD 

HL,{addr) 

LOau  ML  uireci 

LD 

reg,(xy+disp) 

Load  Register  indexed 

LD 

rp,(addr) 

Load  Register  Pair  Direct 

LD 

XV,  (addr) 

Load  Index  Register  Direct 

LD 

(BC)  or  (DE),A 

Store  Accumulator  Secondary 

LD 

(addrt.HL 

otore  HL  LJirect 

LD 

(xY+disp),reg 

Store  Register  Indexed 

LD 

(addri.rp 

Store  Register  Pair  Direct 

LD 

(addr), XV 

Store  Index  Register  Direct 

LD 

(HL),data 

Store  Immediate  to  Memory 

LD 

(xy+dlsp),data 

Store  Immediate  to  Memory  Indexed 

LDD.  LDDR 

Load,  Decrement  (Repeat) 

LDI.  LDIR 

Load,  Increment,  (Repeat) 

NEG 

Negate  (Twos  Complement)  Accumulator 

NOP 

No  Operation 

OR 

Logical  Un 

OUTD.  OTDR 

Output.  Decrement,  (Repeat) 

OUTI.  OTIR 

Output,  increment,  (Repeat) 

RES 

Reset  Bit 

RET! 

Return  from  Interrupt 

RL 

Rotate  Left  Through  Carrv 

RLC 

Rotate  Left  Circular 

RLCA 

Rotate  Accumulator  Left  Circular 

RR 

Rotate  Right  Through  Carrv 

RRC 

Rotate  Right  Circular 

RRCA 

Rotate  Accumulator  Right  Circular 

SET 

Set  Bit 

SRA 

Shift  Right  Arithmetic 

XOR 

Logical  Exclusive  OR 
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Table  3-3.  Seldom  Used  Instructions  of  the  Z80 


Instruction  Code 

Meaning 

ADC 

HL,rp 

Add  Register  Pair  with  Carry  to  HL 

CCF 

Complement  Carry  Flag 

EXX 

Exchange  Register  Pairs  and  Alternatives 

IM 

n 

Set  Interrupt  Mode 

RETN 

Return  from  Non-Maskable  Interrupt 

RLD 

Rotate  Accumulator  and  Memory  Left  Decimal 

RRD 

Rotate  Accumulator  and  Memory  Right  Decimal 

no  1 

Restart 

SBC 

Subtract  with  Carry  (Borrow) 

SCF 

Set  Carry  Flag 

LD 

A,l 

Load  Accumulator  from  Interrupt  Vector  Register 

LD 

A.R 

Load  Accumulator  from  Refresh  Register 

LD 

I.A 

Store  Accumulator  to  Interrupt  Vector  Register 

LD 

R.A 

Store  Accumulator  to  Refresh  Register 

LD 

SP.HL 

Move  HL  to  Stack  Pointer 

LD 

SP.xy 

Move  Index  Register  to  Stack  Pointer 

ABBREVIATIONS 

These  are  the  abbreviations  used  in  this  chapter: 

A,F.B.C,D,E.H,L       The  8-bit  registers.  A  is  the  Accumulator  and  F  is  the  Flag  Word. 

AF'.BC'.DE'.HL'       The  alternate  register  pairs 

addr  A  16-bit  memory  address 

x(b)  Bit  b  of  8-bit  register  or  memory  location  x 

cond  Condition  for  program  branching.  Conditions  are: 

NZ  -  Non-Zero  (Z  =  Oi 
Z    -Zero(Z  =  1! 
NC  -  Non-carry  (C  =  0) 
C    -  Carry  iC  =  1) 
PO  -  Parity  Odd  (P  =  Oj 
PE  -  Parity  Even  (P  =  1) 
P    -  Positive  Sign  (S  =  0) 
M  -  Negative  Sign  (S  =  1) 


data  An  8-bit  binary  data  unit 

data16  A  16-bit  binary  data  unit 

disp  An  8-bit  signed  binary  address  displacement 

xxiHIl  The  high-order  8  bits  of  a  16-bit  quantity  xx 

I  Interrupt  Vector  register  (8  bits) 

IX  lY  The  Index  registers  (16  bits  each) 

label  A  16-bit  instruction  memory  address 

xx(LO)  The  low-order  8  bits  of  a  16-bit  quantity  xx 

LSB  Least  Significant  Bit  (Bit  0) 

MSB  Most  Significant  Bit  (Bit  7) 

PC  Program  Counter 

port  An  8-bit  I/O  port  address 
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pr  Anv  of  the  following  register  pairs; 

BC 
DE 
HL 
AF 

R  The  Refresh  register  (8  bits) 

reg  Anv  of  the  following  registers: 

A 
B 
C 
D 
E 
H 
L 

rp  Any  of  the  following  register  pairs; 

BC 
DE 
HL 
SP 

SP  Stack  Pointer  (16  bits) 

XV  Either  one  of  the  Index  registers  (IX  or  lY) 

Object  Code  bbb     Bit  number  000  (LSB)  to  1 1 1  (MSB) 

ccc     Condition  code     000  =  non-zero 
001  =zero 

010  =  no  carry 

01 1  =  carry 

100  =  parity  odd 

101  =  parity  even 
110  =  positive  sign 
111=  negative  sign 

ddd    Destination  register  —  sanne  coding  as  rrr 

ppqq  A  16-bit  nnemory  address 

rrr       Register  1 1 1  =  A 

000  =  B 

001  =C 

010  =  D 

011  =E 

100  =  H 

101  =L 

sss     Source  register  —  same  coding  as  rrr 

X        Index  register  0  =  IX 

1  =IY 

XX      Register  pair         00  =  BC 
01  =DE 

10  =  HL 

1 1  =  SP  (rp)  or  AF  (pr) 
XXX     Restart  code  (000  to  1111 

yv  An  8-bit  binary  data  unit 
yyyy   A  16-bit  binary  data  unit 
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Statuses  The  Z80  has  the  following  status  flags: 

C        -  Carp/  status 
Z        -  Zero  status 
S         -  Sign  status 
P/0     -  Parity/Overflow  status 
Ac      -  Auxiliary  Carry  status 
N        -  Subtract  status 

The  following  symbols  are  used  in  the  status  columns: 

X        -  flag  is  affected  by  operation 

(blank)  -  flag  is  not  affected  by  operation 

1        -  flag  is  set  by  operation 

0        -  flag  is  reset  by  operation 

U        -  flag  IS  unknown  after  operation 

P        -  flag  shows  parity  status 

0  -  flag  shows  overflow  status 

1  -  flag  shows  interrupt  enabled/disabled  status 

[[]]  Memory  addressing:  1)    the  contents  of  the  memory  location 

whose  address  is  contained  in  the  designated  register,  2)  an 
I/O  port  whose  address  is  contained  in  the  designated  register. 

[  1  The  contents  of  a  register  or  memory  location. 

For  example: 

[[HL]]  -  [[HL]]  +  1 

indicates  that  the  contents  of  the  memory  location  addressed  by 
the  contents  of  HL  are  incremented,  whereas: 

(HLl  —  [HLl  +  1 

indicates  that  the  contents  of  the  HL  register  itself  are  incre- 
mented. 

A  Logical  AND 

V  Logical  OR 

-V-  Logical  Exclusive-OR 

—  Data  IS  transferred  in  the  direction' of  the  arrow 

 '  Data  IS  exchanged  between  the  two  locations  designated  on  either 

side  of  the  arrows. 
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INSTRUCTION  MNEMONICS 

Table  3-4  summarizes  the  Z80  instruction  set.  The  IVINEMONIC  column  shows  the 
instruction  mnemonic  (IN,  OUT,  LD).  The  OPERAND  column  shows  the  operands, 
if  any,  used  with  the  instruction  mnemonic. 

The  fixed  part  of  an  assembly  language  instruction  is  shown  in  UPPER  CASE.  The 
variable  part  (immediate  data,  I/O  device  number,  register  name,  label  or  address) 
is  shown  in  lower  case. 

For  closely  related  operands,  each  type  is  listed  separately  without  repeating  the 
mnemonic.  For  instance,  examples  of  the  format  entry 

LD  rp,(addrS 
xy,(addr) 

are-      LD  BC,(DAT2i 
LD  IX,(MEM) 

INSTRUCTION  OBJECT  CODES 

The  object  code  artd  instruction  length  in  bytes  are  shown  in  Table  3-4  for  each 
instruction  variation.  Table  3-5  lists  the  object  codes  in  numerical  order. 

For  instruction  bytes  without  variations,  object  codes  are  represented  as  two 
hexadecimal  digits  (e.g.,  3F). 

For  instruction  bytes  with  variations  in  one  of  the  two  digits,  the  object  code  is 
shown  as  one  4-bit  binary  digit  and  one  hexadecimal  digit  (e.g.,  1 1  x  1  D)  in  Table 
3-5.  For  other  instruction  bytes  with  variations,  the  object  code  is  shown  as  eight 
binary  digits  (e.g.,  OlsssOOl). 

INSTRUCTION  EXECUTION  TIMES 

Table  3-4  lists  the  instruction  execution  times  in  clock  periods.  Real  time  can  be 
obtained  by  diyiding  the  given  number  of  clock  periods  by  the  clock  frequency.  For 
example,  for  an  instruction  that  requires  7  clock  periods,  a  4  MHz  clock  will  result  m  a 
1.75  microsecond  execution  time. 

When  two  possible  execution  times  are  shown  (i.e.,  5/11),  it  indicates  that  the 
number  of  clock  periods  depends  on  condition  flags.  The  first  time  is  for  "condi- 
tion not  met,"  whereas  the  second  is  for  "condition  met." 

STATUS 

The  SIX  status  flags  are  stored  in  the  Flag  register  (F)  as  follows: 

c 


p/0 


J 


■  These  bits  are  not  used 

-  Cany  status  (carrv  out  of  bit  7) 
•  Subtract  status 

{1  after  subtract  operation,  0  otherwise! 
.  Parity/Overflow 
(for  logical  operations,  t  for  even,  0  for  odd  pantv. 
For  arithmetic,  1  for  overflow) 

-  Auxiliary  Carry  status  {carry  out  of  bit  3) 

■  Zero  status  (1  for  zero,  0  for  nonzero! 

■  Sign  status  {value  of  bit  7! 
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In  the  individual  instruction  descriptions,  the  effect  of  instruction  execution  on 
status  is  illustrated  as  follows: 

S      Z      Ac  P/0    N  C 


Modified  to  reflect  results  of  execution 
Uncondittonailv  reset  to  0 
Unconditionaily  set  to  1 
Unchanged 
Unknown 


An  X  identifies  a  status  that  is  set  or  reset.  A  0  identifies  a  status 
tliat  IS  always  cleared.  A  1  identifies  a  status  that  is  always  set.  A 
blank  means  the  status  does  not  change.  A  question  mark  (?) 
means  the  status  is  not  known. 


STATUS 
CHANGES 

WITH 

INSTRUCTION 
EXECUTION 
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Taole  3-4  A  Summary  of  the  Z80  Instruction  Set 


CO 


Typo 

Mnemonic 

Oporand 

Object  Code 

Bytes 

Clock 

Status 

Operation  Performed' 

Cycles 

C 

Z 

s 

P/0 

Ac 

N 

IN 

AJportI 

DB  yy 

2 

10 

[  A]  -  (  port] 

Input  to  Accumulator  from  directly  addressed  I/O  port 
Address  Bus:  A0-A7:  port 
A8-A15:  [A] 

IN 

regie) 

ED  OldddOOO 

2 

1 1 

X 

X 

p 

X 

0 

( rag]  -  [(  C]j 

Input  to  register  from  I/O  port  addressed  by  the  contents  of  C  " 

If  second  byte  is  ^O^g  only  the  flags  will  be  affected 
Repeat  until  [  Bj  =  0: 
[[  HLl]-[fCII 

[  a]  -  [  B]  - 1 

{  HL]  —  {HL]  +  1 

Transfer  a  block  of  data  from  I/O  port  addressed  by  contents  of  C 
to  memory  location  addressed  by  contents  of  HL.  going  from  low 
addresses  to  high  Contents  of  B  serve  as  a  count  of  bytes  remain- 
ing to  be  transferred" 

INIR 

ED  B2 

2 

20/1  5'* 

1 

? 

? 

7 

1 

g 

INDR 

ED  BA 

2 

20/15" 

1 

? 

? 

? 

1 

Repeat  until  (  8]  =  0; 

IfHUj-K  Cj] 
1B]-{B]  -  1 
[HL!— [HL]  -  1 

Transfer  a  biock  of  data  from  I/O  port  addressed  by  contents  of  C 
to  memory  location  addressed  by  contents  of  HL,  going  from  high 
addresses  to  tow  Contents  of  B  servers  a  count  of  bytes  rem'aining 
to  be  transferred  " 

INI 

ED  A2 

2 

15 

X 

? 

? 

? 

1 

[(  HL]  -  ([  CI] 

f  BI  -  [  B]  -  1 

[HLI  — [HLI  +  1 
Transfer  a  byte  of  data  from  I/O  port  addressed  by  contents  of  C  to 
memory  location  addressed  by  contents  of  HL  Decrement  byte 
count  and  increment  destination  address  *" 

i:  A0-A7:  [CI 

A8-At5:  [B]  Table  3-4  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


Clock 

status 

Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Operation  Performed 

Cycles 

C 

S 

P/0 

'^C 

IND 

ED  AA 

2 

15 

X 

? 

7 

7 

1 

I1HU1-[[C1) 
(  Bl  -  I  Bl  -  1 
[  HLl  —  (  HL)  -  1 

Transfer  a  byte  of  data  from  I/O  port  addressed  by  contents  of  C  to 
memory  location  addressed  by  contents  of  HL  Decrement  both 
byte  count  and  destination  address  " 

OUT 

Iportl.A 

03  yv 

2 

1 1 

(  port!  —  [  A] 

Output  from  Accumulator  to  directly  addressed  I/O  port 
Address  Bus:  A0-A7:  port 
AB-A16:  (A) 

OUT 

(O.reg 

ED  OlsssOOl 

2 

12 

(1  CD  -  t  regi 

Output  from  register  to  I/O  port  addressed  by  the  contents  of  C  " 

OTIR 

ED  B3 

2 

20/16" 

1 

? 

7 

7 

1 

Repeat  until  [  Bl  =  0: 

uedl 

(1  CD  -  ([  HLll 

1  B)  -  [  Bl  -  1 

(  HLl  -  1  HL)  +  1 

)  (Con 

Transfer  a  block  of  data  from  memory  location  addressed  by  con- 

tents of  HL  to  I/O  port  addressed  by  contents  of  C,  going  from  low 

memory  to  high  Contents  of  B  serve  as  a  count  of  bytes  remaining 
to  be  transferred  '  * 

OTDR 

ED  BB 

2 

20/15" 

1 

7 

7 

7 

1 

Repeat  until  (  B)  =  0: 
1(  Cll  -  t(  HLl) 
(  Bl  -  (  Bl  -  1 
[  HLl  —  1  HLl  -  1 

Transfer  a  block  of  data  from  memory  location  addressed  by  con- 
tents of  HL  to  I/O  port  addressed  by  contents  of  C,  going  from  high 
memory  to  low  Contents  of  B  serve  as  a  count  of  bytes  remaining 
to  be  transferred  "* 

■  Table  3-4  A  Summary  of  the  Z80  Instruction  Set  (Continued) 

A8-A15:  tB) 


Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 
Cycles 

Status 

Operation  Performed 

C 

z 

s 

P/0 

Ac 

N 

1/0  (Continued) 

OUTI 
OUTD 

ED  A3 
ED  AB 

2 
2 

15 
15 

X 
X 

? 

7 

7 
7 

7 
7 

1 
1 

[[  CI]  -  [[  HL)] 

[  B]  -  (BI  -  1 

(HL]~[HL)  -i-  1 
Transfer  a  byte  of  data  from  memory  tocation  addressed  by  con- 
tents of  HL  to  I/O  port  addressed  by  contents  of  C  Decrement  byte 
count  and  increment  source  address  " 

[[C]j-[(HL]I 

[  B]  -  [  B]  -  1 

[  HLI  -  I  HL]  -  1 

Transfer  a  byte  of  data  from  memory  location  addressed  by  con- 
tents of  HL  to  i/0  port  addressed  by  contents  of  C  Decrement  both 
byte  count  and  source  address 

LD 

A,(addr} 

3A  ppqq 

3 

1  3 

I  Aj     E  addrl 

Load  Accumulator  from  directly  addressed  memory  location 

LD 

HL.Iaddr} 

2A  ppqq 

3 

1  6 

I  Hi  —  I  addr  +  1  J,  i  LI  —  [  addr] 

Load  HL  from  directly  addressed  memory 

LD 

rp,(addr) 

ED  OlxxtOI 1  ppqq 

4 

20 

[  rp{HI)]  —  (  addr  +  1],  [  rp(LO)j  —  [  addr]  or 

a 

xyjaddr) 

11x11101  2A  ppqq 

4 

20 

I  xytHui  *—  I  addr  +  1  j.  1  xy(LO)]  *—  {  addr] 

ferei 

Load  register  pair  or  index  register  from  directly  addressed  memo- 

DC 

£r 

LD 

(addrl.A 

32  ppqq 

3 

1  3 

ry 

I  addrj  —  {  Al 

o 

Store  Accumulator  contents  in  directly  addressed  memory  location 

E 

LD 

(addrj.HL 

22  ppqq 

3 

16 

[addr+  1  ]  —  1  Hj,  I  addrl  —  1  L] 

Store  contents  of  HL  to  directly  addressed  memory  location 

> 

to 

LD 

iaddr),rp 

ED  OlxxOOII  ppqq 

4 

20 

i  addr  +  1]  —  ( rp(HI)].  i  addr]  —  { rp(LO)]  or 

E 

(addrl.xy 

11x11101  22  ppqq 

4 

20 

{  addr  +  1  ]  —  {  xy(HI)j,  [  addrj  —  [  xy(LO)] 

al 

Store  contents  of  register  pair  or  index  register  to  directly  ad- 

dressed memory 

LD 

A.tBCI 

OA 

1 

7 

[A]-l[BCj]  or{A!-l(DE]l 

A,(DE1 

1A 

1 

7 

Load  Accumulator  from  memory  location  addressed  by  the  con- 

tents of  the  specified  register  pair 

Table  3-4  A  Summarv  of  the  Z80  Instruction  Set  (Continued) 


Type 

MnQRionic 

Operand 

Object  Code 

Bytes 

Clock 

Status 

Operation  Performed 

Cycles 

C 

z 

s 

P/0 

*c 

N 

LD 

reg,(HLl 

OldddllO 

1 

7 

t  reg]  -  11  HLll 

CD 

Load  register  from  memory  location  addressed  by  contents  of  HL 

U 

LD 

(BC),A 

02 

1 

7 

([BCll  ^[  A]  or  IIDEU  —  ( Al 

(DE),A 

1 2 

1 

7 

Store  Accumulator  to  memory  location  addressed  by  the  contents 

»  — 
DC  "D 

of  the  specified  register  pair 

O  1 

LD 

(HL).reg 

0111 Osss 

1 

7 

(1  HLll  —  1  regl 

Store  register  contents  to  memory  location  addressed  by  the  con- 

1 § 

tents  of  HL 

LD 

reg,(xv+disp) 

11x11 101  Oldddl  10 

3 

1 9 

( regl     [[  xyl  +  dispi 

a 

E 

Load  register  from  memory  location  using  base  relative  addressing 

Ql 

LD 

i v\f  4- Hi<^n)  r0fi 

1 1x1 1 101  01 1  lOsss 

3 

1 9 

{[  xyl  +  displ ' —  [  regl 
Store  register  to  memory  location  addressed  relative  to  contents  of 
Index  register 

LDIR 

ED  BO 

2 

20/16" 

0 

0 

0 

Repeat  until  1  BC]  =  0: 
((  DEll  -  (1  HLll 
[  DEI  —  I  DEI  +  1 
(HLl  ^(HLl  +  1 

JI 
o 

(  BC]  -  (  BCl  -  1 

Transfer  a  block  of  data  from  the  memory  location  addressed  by 

« 

the  contents  of  HL  to  the  memory  location  addressed  by  the  con- 

-a 
t: 
a 

tents  of  DE,  going  from  low  addresses  to  high  Contents  of  BC 

o 

serve  as  a  count  of  bytes  to  bo  transferred 

c 

LDDR 

ED  B8 

2 

20/16" 

0 

0 

0 

Repeat  until  I  BCI  =  0: 

CO 

((  DEII  -  (1  HLll 

1  DEI  —  (  DEI  -  1 

O 

(HLl  —  (HLl  -  1 

m 

[  BCI  —  [  BCl  -  1 
Transfer  a  block  of  data  from  the  memory  location  addressed  by 
the  contents  of  HL  to  the  memory  location  addressed  by  the  con- 
tents of  DE,  going  from  high  addresses  to  low  Contents  of  BC 
serve  as  a  count  of  bytes  to  be  transferred. 

Table  3 


1-4  A  Summary 


of  the  Z80  Instruction  Set  (Continued) 


VI 


Status 

Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 

Operation  Performed 

Cycles 

C 

z 

S 

P/0 

Ac 

N 

LDI 

ED  AO 

2 

16 

X 

0 

0 

([  DEU  -  1(  HLll 
I  DE)  —  I  DEI  +  1 
IHLl-iHLl  +  1 
(  BCl  —  (  BCl  -  1 

Transfer  one  byte  of  data  from  the  memory  location  addressed  by 
the  contents  of  HL  to  the  memory  location  addressed  by  the  con- 
tents of  DE  Increment  source  and  destination  addresses  and  decre- 
ment byte  count 

LDD 

ED  A8 

2 

16 

X 

0 

0 

(( DEI] -(1  HLll 

(  DEI  -  [  DEI  -  1 

3 

(  HLl  -  (  HLl  -  1 

.S 

t  BC!  -  [  BCl  -  1 

o 
O 

Transfer  one  byte  of  data  from  the  memory  location  addressed  by 

the  contents  of  HL  to  the  memory  location  addressed  by  the  con- 

tents of  DE  Decrement  source  and  destination  addresses  and  byte 

w 

count 

XI 

1= 

CPIR 

ED  B1 

2 

20/16" 

X 

X 

X 

X 

1 

Repeat  until  [  Al  =  [[  HLll  or  1  BCl  =  0: 

at 

I  Al  -  K  HLll  (only  flags  are  affected) 

01 

1  HLl  —  1  HLl  +  1 

c 
ta 

(  BCl  -  (  BCl  -  1 

Compare  contents  of  Accumulator  with  those  of  memory  block  ad- 

u 
o 

dressed  by  contents  of  HL.  going  from  low  addresses  to  high.  Stop 

m 

when  a  match  is  found  or  when  the  byte  count  becomes  zero 

CPDR 

ED  B9 

2 

20/16" 

X 

X 

X 

X 

1 

Repeat  until  1  Al  =  ([  HLll  or  [  BCl  =  0: 
(  Al  -  ([  HLll  (only  flags  are  affected! 
[  HLl  -  (  HLl  -  1 
(  BCl  -  (  BCl  -  1 

Compare  contents  of  Accumulator  with  those  of  memory  block  ad- 
dressed by  contents  of  HL.  going  from  high  addresses  to  low  Stop 
when  a  match  is  found  or  when  the  byte  count  becomes  zero 

Table  3-4  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


Type 

Mnemonic 

Operand 

Object  Cods 

Bytes 

Clock 
Cycles 

Status 

Operation  Performed 

C 

z 

s 

P/0 

*C 

N 

Block  Transfer  and 
Search  (Continued) 

CPI 
CPD 

ED  Al 
ED  A9 

2 
2 

16 
16 

X 
X 

X 
X 

X 
X 

X 
X 

1 
1 

1  Al  .  [(  HLll  (only  flags  are  affected) 
I  HU  —  [  HU  +  1 
(  BC]  —  (  BCl  -  1 

Compare  contents  of  Accumulator  with  those  of  memory  location 
addressed  by  contents  of  ML  Increment  address  and  decrement 
byte  count 

1  Al  -  [[  HU)  (only  flags  are  affected) 

(  HLl  —  1  HU  -  1 

(  BC]  -  1  BC!  -  1 

Compare  contents  of  Accumulator  with  those  of  memory  location 
addressed  by  contents  of  HL  Decrement  address  and  byte  count 

ADD 

A,(HL) 

86 

X 

X 

X 

0 

X 

0 

I  A]  ^  1  Al  4-  [(  HU]  or  t  Al  —  I  Al  +  [[  xy]  +  displ 

A  (xy  +disp) 

11x11101  86  disp 

3 

1 9 

Add  to  Accumulator  using  implied  addressing  or  base  relative  ad- 

dressing 

ADC 

A.(HL) 

8E 

1 

7 

Q 

Q 

(  Al  —  t  Al  +  1(  HLll  +  C  or  (  Al  —  I  Al  +  [|  xyl     displ  +  C 

o 

AJxy  4-disp) 

11x1 1101  8E  disp 

3 

19 

Add  with  Carry  using  implied  addressing  or  base  relative  address- 

1 

SUB 

(HU 

96 

1 

7 

X 

X 

X 

0 

X 

1 

1  Al  —  (  Al  -  II  HLll  or  [  Al  —  (  Al  -  (1  xyl  +  displ 

s 

(xy  +  disp) 

11x1 1 101  96  disp 

3 

19 

Subtract  from  Accumulator  using  implied  addressing  or  base  rela- 

> 

tive  addressing 

o 

SBC 

A.(HL) 

9E 

1 

7 

X 

X 

X 

0 

X 

1 

1  Al  -  1  Al  -  1(  HLl)  -  C  or  [  A]  —  1  Al  -  [(  xy]  +  displ  -  C 

E 
e 

A.(xy  +  disp) 

11x1 1 101  9E  disp 

3 

19 

Subtract  with  Carry  using  implied  addressing  or  base  relative  ad- 

dressing 

> 
a 

AND 

IHL) 

A6 

1 

7 

0 

X 

X 

p 

1 

0 

(  Al  —  t  Al  A  ((  HLll  or  1  Al  ^  (  Al  A  ((  xyl  +  displ 

•a 
c 
o 

(xy  +  disp) 

11x1 1101  A6  disp 

3 

19 

AND  with  Accumulator  using  implied  addressing  or  base  relative 

o 
o 

addressing 

w 

OR 

(HU 

B6 

1 

7 

0 

X 

X 

1 

0 

I  Al  -  1  Al  V  [|  HLll  or  I  A)  -  [  Al  V  l(  xyl  +  displ 

(xy  +  disp) 

11x1 1 101  B6  disp 

3 

19 

OR  with  Accumulator  using  implied  addressing  or  base  relative  ad- 

dressing 

Table  3-4,  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 

Status 

Operation  Performed 

Cycles 

C 

z 

s 

P/0 

Ac 

N 

Secondary  Memory 
Reference  (Continued) 

XOR 

CP 

INC 
DEC 

(HL) 
(xy  +  disp) 

(HLl 
(xy  disp) 

IHLI 
(xy  +  disp) 

(HL) 
(xy  +  disp) 

A6 

1 1x1 1101  AE  disp 
BE 

11x11101  BE  disp 
34 

11x11101  34  disp 
35 

11x11101  35  disp 

1 
3 

1 

3 

1 
3 
1 
3 

7 

19 
7 

19 

11 
23 
11 
23 

0 
X 

X 

X 

X 
X 

X 

X 

X 
X 

p 

0 

0 
0 

1 

X 

X 
X 

0 
1 
0 

1 

[  A]  -  !  A]        HLl)  or  1  A]  -  ( A]  AA  (1  xy]  +  disp] 
Exclusive-OR  with  Accumulator  using  implied  addressing  or  base 
relative  addressing 

(A)  -  ((HLi)  or  [A]  -  (Ixyl  +  disp] 
Compare  with  Accumulator  using  implied  addressing  or  base  rela- 
tive addressing  Only  the  flags  are  affected 

([  HLl)  —  [(  HLll  +  1  or  [[  xyl  +  disp)  —  {[  xy]  +  disp]  +  1 
Increment  using  implied  addressing  or  base  relative  addressing 

t(  HLll  —  ((  HLl]  -  1  or  It  xyl  +  disp]  —  ((  xy]  +  disp]  -  1 
Decrement  using  implied  addressing  or  base  relative  addressing 

RLC 

(HL) 

CB  06 

2 

15 

p 

Q 

FhM '  —  "h-" 

o 

(xy  +  disp) 

11x11101  CB  disp 
06 

4 

23 

[[  HUJ  or  ((  xy]  +  disp] 
Rotate  contents  of  memory  location  (implied  or  base  relative  address- 
ing) left  with  branch  Carry 

d  Rots 

RL 

(HL) 

CB  16 

2 

16 

X 

X 

X 

p 

0 

0 

1  1  c  1^  1  7    0 

y  Shift  an 

(xy  -f  disp) 

11x11101  CBdisp 
16 

4 

23 

[( HL]]  or  f[  xv]  +  disp] 
Rotate  contents  of  memory  location  left  through  Carry 

Pernor 

RRC 

(HL) 

CB  OE 

2 

15 

X 

X 

X 

p 

0 

0 

7   0  1 — c  1 

(xy  +  disp) 

llx'11101  CBdisp 
OE 

4 

23 

[{  HLll  or  [1  xyl  +  disp] 
Rotate  contents  of  memory  location  right  with  branch  Carry 

Table  3- 


1-4,  A  Summary 


of  the  Z80  Instruction  Set  (Continued) 


o 


Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 

Status 

Operation  Performed 

Cycles 

C 

z 

s 

P/0 

Ac 

N 

snLI 

1  5 

X 

X 

p 

0 

0 

L^J  - 

 ^  0  1  Wcl — 1 

(xy  +  disp) 

1  1x11101  CB  disp 
IE 

4 

23 

[(  HLll  or  It  xyl  +  disp) 
Rotate  contents  of  memory  location  rigtit  through  Carry 

a> 
=1 
_c 

SLA 

(HU 
(xy  +  disp) 

CB  26 
1 1x1 1 101  CB  disp 

2 
4 

15 
23 

X 

X 

X 

p 

0 

0 

1  c  |«4  1  7             0  0 

1(  HLl]  or  ([  xy)  +  disp) 

c 

26 

Shift  contents  of 

memory  location  left  and  clear  LSB  (Arithmetic 

o 
o 

ffl 

Shift) 

hlft  and  Rotat 

SRA 

(HU 
(xy  +  disp) 

CB  2E 
11x11101  CBdisp 

2E 

2 
4 

15 
23 

X 

X 

X 

p 

0 

0 

 ^  0  1  Mcl 

It  HUl  or  t(  xyl  +  disp) 

CO 

> 

Shift  contents  of  memory  location  right  and  preserve  MSB 

o 
E 

t  (Arithmetic  Shift) 

o 

s 

SRL 

(HL) 
(xy  +  disp) 

CB  3E 
1 1x1 1 101  CB  disp 

3E 

2 
4 

16 
23 

X 

X 

X 

p 

0 

0 

0           7   ►  0  |— — »»j~C  1 

11  HLl)  or  It  xy]  +  disp) 
Shift  contents  of  memory  location  right  and  clear  MSB  (Logical  Shift) 

Table  3-4  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


Type 

Mnemonic 

Operand 

Clock 

Status 

Operation  Performed 

Object  Code 

Bytes 

Cycles 

C 

Z 

S 

P/0 

*c 

N 

LD 

reg.data 

OOdddllO  yy 

2 

7 

( regj  data 

Load  immediate  into  register 

o 

.2 

LD 

rpdatalS 

OOxxOOOl  yyyv 

3 

10 

{ rp)  ^  data  16  or  (  xyj     datal  6 

T3 
O 

xy.dataie 

1 1x1  1 101  21  yyyy 

4 

14 

Load  1 6  bits  of  immediate  data  into  register  pair  or  Index  register 

B 
E 

LD 

(HLI.data 

36  yy 

2 

10 

I[  HL]]  —  data  or  [[  xy]  +  disp]  ^  data 

(xy'+  disp). 

11x11101  36  disp  yy 

4 

19 

Load  immediate  into  memory  location  using  implied  or  base  relative 

data 

addressing 

JP 

label 

C3  ppqq 

3 

10 

( PC]  —  label 

Jump  to  instruction  at  address  represented  by  label 

E 

JR 

disp 

18  (disp-2) 

2 

12 

[  PC] [  PCI  +  2  +  {disp-2} 

-1 

Jump  relative  to  present  contents  of  Program  Counter 

JP 

(HL) 

E9 

1 

4 

I  rCj  —  [  HL]  or  1  rCi  ^  I  xyj 

(xy) 

1 1x1 1 101  E9 

2 

8 

Jump  to  address  contained  in  HL  or  Index  register 

CALL 

label 

CD  ppqq 

^  y 

If  *?PI  -  1  ]  ^  f  prINDI 

ff  opi ,  21  —  r  PCil  nil 

E  Or]       [  or  J  -  Z 

( PC]  —  (abel 

c 

3 

Jump  to  subroutine  starting  at  address  represented  by  label 

O 
C 

CALL 

cond.label 

1 1ced 00  ppqq 

3 

10/17 

Jump  to  subroutine  if  condition  is  satisfied;  otherwise,  continue  in 

"O 

sequence. 

to 

RET 

C9 

1 

10 

[PC(LO)]-[[  SP|] 

To 
U 

[PC(HI))-((SP]  +  1] 

o 

r  Qpi  ,  r  Qpi  J.  o 

_c 

Return  from  subroutine 

3 
O 

Jq 

RET 

cond 

1 1 cccOOO 

1 

6/1  1 

Return  from  subroutine  if  condition  is  satisfied;  otherwise,  continue 

3 
CO 

in  sequence 

Table  3-4,  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


Clock 

status 

Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Operation  Performed 

Cycles 

C 

z 

S 

P/0 

*c 

N 

ADD 

A.data 

06  yy 

2 

7 

X 

X 

X 

0 

X 

0 

[  A)  —  1  A)  +  data 
Add  immediate  to  Accumulator 

ADC 

A.data 

CE  yy 

2 

7 

X 

X 

X 

0 

I  Ml '    I  A]  -r  aata  + 
Add  immediate  with  Carry 

SUB 

data 

D6  yy 

2 

7 

X 

X 

X 

0 

X 

1 

[  A]  —  (  Al  -  data 

01 

"S 

Subtract  innmGdiBte  from  Accumulator 

o 
a 

SBC 

A  data 

ut  yy 

2 

X 

X 

0 

X 

1 

(  A]  —  [  Aj  -  data  -  C 

O 

Subtract  immediate  with  Carry 

<D 

a 

AND 

ata 

c6  yy 

X 

p 

0 

{  ^1 »—  J  data 

'"B 

<D 

E 
E 

OR 

a  a 

F6  yy 

2 

-J 

0 

X 

p 

0 

OR  immadiate  witb  Accumulator 

XOR 

data 

EE  yy 

Q 

X 

p 

0 

Exclusive-OR  immediate  with  Accumutator 

CP 

data 

FE  yy 

2 

7 

X 

X 

X 

0 

X 

1 

[  Al  -  data 

Compare  immediate  data  with  Accumulator  contents;  only  the 
flags  are  affected 

JP 

cond.label 

1  IcccOlO  ppqq 

3 

1 0 

IT  cono,  inen  t  rv]  idoei 
Jump  to  instruction  at  address  represented  by  label  if  the  condition 
is  true 

JR 

C.disp 

38  (disp-2) 

2 

7/12 

If  C=  1.  then  [PC]  —  EPC]  +  2  +  {disp  -  2) 

c 
o 

Jump  relative  to  contents  of  Program  Counter  if  Carry  flag  is  set 

'•B 

JR 

NCdisp 

30  ldisp-21 

2 

7/12 

If  C  =  0,  then  C  PC]  —  [  PC]  +  2  +  {disp  -2) 

c 
o 

Jump  relative  to  contents  of  Program  Counter  if  Carry  flag  is  reset 

o 

c 

JR 

Z.disp 

28  ldisp-21 

2 

7/12 

tf  Z  =  1.  than  [  PC]  —  { PC]  +  2  +  (disp  -2) 

o 
a 

Jump  relative  to  contents  of  Program  Counter  if  Zero  flag  is  set 

E 

JR 

NZ,disp 

20  ldisp-2) 

2 

7/12 

If  Z  =  0,  then  [  PC]  —  [  PC]  +  2  +  {disp  -2) 

DJNZ 

disp 

10  ldisp-2) 

2 

B/13 

Jump  relative  to  contents  of  Program  Counter  if  Zero  flag  is  reset 
[  B]  -  (  8]  -  1 

If  [  B]  ^0,  then  [  PC]  +  2  +  {disp  ~2) 
Decrement  contents  of  B  and  Jump  relative  to  contents  of  Program 
Counter  if  result  is  not  0. 

Table  3-4  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 

Status 

Operation  Performed 

Cycles 

C 

Z 

s 

P/0 

Ar 

N 

LD 

dstsrc 

Oldddsss 

1 

4 

[  dstl  —  (  srcl 

Move  contents  of  source  register  to  destination  register  Register 
designations  src  and  dst  may  eacli  be  A,  B,  C.  D,  E.  H  or  L 

LD 

A,l 

ED  57 

2 

9 

X 

X 

1 

0 

0 

1  A]  -  [  11 

Move  contents  of  Interrupt  Vector  register  to  Accumulator 

LD 

A.R 

ED  5F 

2 

9 

X 

X 

1 

0 

0 

lAl-lRl 

Move  contents  of  Refresh  register  to  Accumulator 

LD 

l,A 

ED  47 

2 

9 

(II -I  A! 

Load  Interrupt  Vector  register  from  Accumulator 

LD 

R,A 

ED  4F 

2 

9 

1  Rl  -  (  Al 
Load  Refresh  register  from  Accumulator 

LD 

SP.HL 

F9 

1 

6 

1  SPl  —  (  HL) 

> 

Move  contents  of  HL  to  Stack  Pointer 

0 

S 

LD 

SP.xy 

11x1 1 101  F9 

2 

10 

I  SPl  -  (  xy] 

o 

Move  contents  of  Index  register  to  Stack  Pointer 

m 

"5 

EX 

OE.HL 

EB 

1 

4 

(DEI  [  HL] 

o 

DC 

Exchange  contents  of  DE  and  HL 

EX 

AF.AF' 

08 

1 

4 

[AFl  [AF'l 

(0 

"6 

Exchange  program  status  and  alternate  program  status 

cc 

EXX 

09 

1 

4 

/[  BC]\         /[  BC'I  \ 

1  (DEI  )  1  (DE'l  I 

\(HL)/  \(HL']/ 

Exchange  register  pairs  and  alternate  register  pairs 

Table  3-4  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


CO 


Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 
Cycles 

Status 

Operation  Performed 

C 

z 

s 

P/0 

Ac 

N 

ADD 

A.reg 

lOOOOrrr 

1 

4 

X 

X 

X 

0 

X 

0 

1  A|  —  (  A)  +  [  reg] 

Add  contents  of  register  to  Accumulator 

ADC 

A.reg 

lOOOlirr 

4 

X 

X 

X 

0 

X 

0 

(  A]  —  1  A]  +  [  regl  +  C 

Add  contents  of  register  and  Carry  to  Accumulator 

SUB 

reg 

lOOIOrrr 

4 

X 

X 

X 

0 

X 

1 

1  A]  -  [  Al  -  t  regl 

Subtract  contents  of  register  from  Accumulator 

SBC 

A.reg 

1001  Irrr 

4 

X 

X 

X 

0 

X 

1 

(  AI  —  (  A]  -  ( reg]  -  C 

Subtract  contents  of  register  and  Carry  from  Accumulator 

AND 

reg 

lOOOOrrr 

' 

4 

0 

X 

X 

p 

1 

0 

(  A]  -  1  Al  A  [  regl 

AND  contents  of  register  with  contents  of  Accumulator 

OR 

reg 

101  lOrrr 

4 

0 

X 

X 

p 

1 

0 

[  A]  —  I  AI  V  ( reg) 

OR  contents  of  register  with  contents  of  Accumulator 

w 

XOR 

reg 

101 01  err 

1 

4 

0 

X 

X 

p 

1 

0 

iAl-[Al-V-(  regl 

o 
a 

Exclusive-OR  contents  of  register  with  contents  of  Accumulator 

o 

CP 

reg 

101  llrrr 

4 

X 

X 

X 

0 

X 

1 

1  Al  -  ( regl 

o 

Compare  contents  of  register  with  contents  of  Accumulator  Only 

n 

the  flags  are  affected 

© 

ADD 

UUXX IUU1 

1 1 

X 

? 

0 

f  HLl  —  f  HLI  +  f  rol 
t  'lu]     I  III.]  T  I  ipi 

o 

16-bit  add  register  pair  contents  to  contents  of  HL 

m 
'5) 

ADC 

HL.rp 

ED  OlxxlOlO 

2 

15 

X 

X 

X 

0 

? 

0 

1  HLl  -  (  HLl  +  1  rpl  +  C 

(D 
IT 

16-bit  add  with  Carry  register  pair  contents  to  contents  of  HL 

SBC 

HL.rp 

ED  OlxxOOlO 

2 

15 

X 

X 

X 

0 

? 

1 

[  HL)  -  (  HLl  -  [  rpl  -  C 

1 6-bit  subtract  with  Carry  register  pair  contents  from  contents  of 

HL, 

ADD 

IX.pp 

DD  OOxxlOOl 

2 

15 

X 

? 

0 

[  IX)  -  I IX)  +  1  ppl 

16-bit  add  register  pair  contents  to  contents  of  Index  register  IX 

(pp  =  BC,  DE.  IX,  SP) 

ADD 

lY.rr 

FD  OOxxlOOl 

2 

15 

X 

? 

0 

1  lYl  —  ( lYl  +  [  rrl 

16-bit  add  register  pair  contents  to  contents  of  Index  register  lY 

(rr  =  BC,  DE.  lY,  SP) 

Table  3-4,  A  Summarv  of  the  Z80  Instruction  Set  (Continued) 


Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 

Status 

Operation  Performed 

Cycles 

C 

z 

s 

P/0 

Ac 

N 

Register  Operate 

DAA 
CPL 
NEG 
INC 
INC 
DEC 
DEC 

reg 

rp 
xy 
reg 

rp 
xy 

27 

2F 

ED  44 

OOrrrlOO 

OOxxOOl 1 
11x11101  23 
OOrrrlOl 

OOxxlOll 
11x11101  2B 

1 
1 

2 
1 

1 

2 
1 

1 
2 

4 
4 
8 
4 
6 

10 
4 

6 

10 

X 
X 

X 

X 
X 

X 

X                 XX  X 

Q-             o      o  o 

X                 X        X  X 

1 
1 
0 

1 

Decimal  adjust  Accumulator,  assuming  tiiat  Accumulator  contents  are 
the  sum  or  difference  of  BCD  operands 
(  A]  -  [  A) 

Complement  Accumulator  (ones  complement) 
[A1-(A]  +  1 

Negate  Accumulator  (twos  complement) 
( reg]  —  ( reg]  +  1 

Increment  register  contents 
[  rpl  ^  [  rp]  +  1  or  [  xy]  —  [  xy]  +  1 

Increment  contents  of  register  or  Index  register 
( reg)  —  ( reg)  -  1 

Decrement  register  contents 
1  rp]  —  (  rp)  -  1  or  (  xy]  —  [  xy]  -  1 

Decrement  contents"  of  register  pair  or  Index  register 

RLCA 

07 

1 

4 

X 

0 

0 

1  C   1  7                     0  I"*! 

(A) 

Rotate  Accumuiator  left  witii  brancii  Carry 

ster  Shift  and  Ro' 

RLA 

17 

1 

4 

X 

0 

0 

(A) 

Rotate  Accumulator  left  tiirougii  Carry 

Regi 

RRCA 

OF 

1 

4 

X 

0 

0 

7   0  1  i«>|  C  [ 

[Al 

Rotate  Accumuiator  right  with  branch  Carry 

Table  3- 


1-4.  A  Summary 


of  the  Z80  Instruction  Set  (Continued) 


Type  I  Mnemonic 


Operand 


Object  Code 


Bytes 


Clock 
Cycles 


S  P/0 


Operation  Performed 


CB  OOOOOrrr 


CB  0001  Orrr 


CB  00001  rrr 


CB  00011  rrr 


CB  OOlOOrrr 


L»»l^   ^  0  J  ^1  c  I — -3 


I  A] 

Rotate  Accumulator  right  through  Carry 


[regl 

Rotate  contents  of  register  left  with  branch  Carry 


[reg] 

Rotate  contents  of  register  left  through  Carry 

l-^sl""?''  ' o'""| — ^~l-^s|°''''c^ 
[  regl 

Rotate  contents  of  register  right  with  branch  Carry 


[  regj 

Rotate  contents  of  register  right  through  Carry 
[  regj 

Shift  contents  of  register  left  and  clear  LSB  (Arithmetic  Shift) 


Table  3- 


1-4.  A  Summary 


of  the  Z80  Instruction  Set  (Continued) 


Type 


Operand 


Object  Code 


Bytes 


Clock 
Cycles 


P/0 


Ac 


Operation  Performed 


CB  OOlOlrrr 


I  7  fiB^  0  I  ^»^^^cj 


Ireg] 


Shift  contents  of  register  right  and  preserve  IVISB  (Arithmetic  Shift) 


0   -»»|  7  »»■  (7J         »<»|  C  j 

I  regl 

Shift  contents  of  register  right  and  clear  iVISB  (Logical  Shift) 

L 


tAl 


Rotate  one  BCD  digit  left  between  the  Accumulator  and  memory  loca- 
tion {implied  addressing)  Contents  of  the  upper  half  of  the  Accumula- 
tor are  not  affected, 


-1  4- 

t 

3 

4 

3 

(Al  t 

ItHLll 

Rotate  one  BCD  digit  right  between  the  Accumulator  and  memory 
location  (implied  addressing)  Contents  of  the  upper  half  of  the  Ac- 
cumulator are  not  affected. 


Table  3-4,  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


status 

Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 

Oporstion  Porformsd 

Cycles 

C 

Z 

g 

P/0 

Aq 

N 

BIT 

b.reg 

CBOIbbbrrr 

2 

8 

X 

? 

? 

1 

0 

z  —Tiiib) 

Zero  f!ag  contains  complement  of  the  selected  register  bit 

BIT 

b.lHLI 
b,(xY4  disp) 

CBOlbbbllO 
11x11101  CBdisp 

2 
4 

12 
20 

X 

? 

? 

1 

0 

Z  -  [[  HL]]{b|  or  Z  -  [[  xy]  +  displ(b) 
Zero  flag  contains  complement  of  selected  bit  of  the  memory  loca- 

OlbbbllO 

tion  (implied  addressing  or  base  relative  addressing) 

.2 

SET 

b.reg 

CB  1 1  bbbrrr 

2 

8 

regfb)  —  1 

3 

Set  indicated  register  bit 

d 

"E 

SET 

b,(HL) 

CB  llbbbllO 

2 

15 

[{  HLiHb)  —  1  or  tl  xy]  +  disp](b)  —  1 

to 

s 

b.(xv  +  disp) 

11x11101  CBdisp 

4 

23 

Set  indicated  bit  of  memory  location  (implied  addressing  or 

llbbbllO 

base  relative  addressing) 

CO 

RES 

b.reg 

CB  lObbbrrr 

2 

8 

r6g(b)  —  0 
Reset  indicated  register  bit 

3-38 

RES 

b.lHU 

CB  lObbbllO 

2 

15 

[[  HL]l(b)  -  0  or  [(  xy]  +  disp)(b)  -  0 

b.(xy  +  disp) 

11x11101  CB  disp 

4 

23 

Reset  indicated  bit  in  memory  location  (implied  addressing  or  base 

lObbbllO 

relative  addressing) 

PUSH 

pr 
xy 

1 IxxOlOl 
1 1x1 1 101  E5 

1 
2 

1 1 
15 

[[  SP]-1]-[pr(HI)] 
ll  SPj-2]  *-  [  pr(LO)j 
[SPi  — [SP]-2 

Put  contents  of  register  pair  or  Index  register  on  top  of  Stack  and 
decrement  Stack  Pointer 

POP 

pr 

1 IxxOOOl 

1 

10 

{  pr(LO}]  -  [[  SPI] 

xy 

11x11101  El 

2 

14 

[pr(HI)]-lESPl  +  1] 

a 

1  SP]  —  [  SP]  -f  2 

s 

EX 

(SPl.HL 
(SP).xv 

E3 

11x11101  E3 

1 
2 

19 
23 

Put  contents  of  top  of  Stack  in  register  pair  or  Index  register  and 

increment  Stack  Pointer 

[HI  aSP]  +  1] 

[L]  [[SPI] 

Exchange  contents  of  HL  or  Index  register  and  top  of  Stack 

Table  3-4„  A  Summary  of  the  Z80  Instruction  Set  (Continued) 


Type 

Mnemonic 

Operand 

Object  Code 

Bytes 

Clock 

Status 

1 

operation  Performed 

Cycles 

C 

z 

s 

P/O 

Ac 

N 

Dl 

F3 

1 

4 

Disable  interrupts 

El 

FB 

1 

4 

Enable  Interrupts 

RST 

n 

1 Ixxxl 1 1 

1 

1 1 

I[SPMj-[PC(Hin 
l[SPl-2j— (PCfLO)] 

[  SPJ  —  (  SPj-2 

iterrupl 

f  or"!  .       la  n\ 

[  PL]  —  (o-n)i  g 

Restart  at  designated  location 

RETI 
RETN 
M 

0 
1 
2 

ED  4D 
ED  45 
ED  46 
ED  56 
ED  5E 

2 
2 
2 
2 
2 

14 
14 
B 
8 
B 

Return  from  interrupt 

Return  from  nonmaskable  interrupt 

Set  interrupt  mode  0,  1.  or  2 

SCF 

37 

1 

4 

1 

0 

0 

C  —  1 

m 

3 

Set  Carry  flag 

a 

CCF 

3F 

1 

4 

X 

? 

0 

C  *-C 

W 

Complement  Carry  flag 

NOP 

00 

1 

4 

No  operation  — volatile  memories  are  refreshed 

HALT 

76 

1 

4 

CPU  halts,  executes  NOPs  to  refresh  volatile  memories 

"Execution  time  shown  is  for  one  iteration 


Table  3-5.  Instruction  Object  Codes  in  Numerical  Order 


OBJECT  CODE 

INSTRUCTION 

00 

NOP 

01  yyyv 

LD 

BC,data16 

02 

LD 

(BO.A 

03 

INC 

BC 

04 

INC 

B 

05 

DEC 

B 

06  yy 

LD 

B.data 

07 

RLCA 

08 

EX 

AF.AF 

09 

ADD 

HL.BC 

OA 

LD 

A,(BC) 

OB 

DEC 

BC 

oc 

INC 

C 

OD 

DEC 

C 

OEyy 

LD 

Cdata 

OF 

RRCA 

10  disp-2 

DJNZ 

disp 

11  yyyy 

LD 

DE.dataie 

12 

LD 

(DE),A 

13 

INC 

DE 

14 

INC 

D 

15 

DEC 

D 

16  yy 

LD 

D.data 

17 

RLA 

18  disp-2 

JR 

disp 

19 

ADD 

HL.DE 

lA 

LD 

A.IDE) 

IB 

DEC 

DE 

1C 

INC 

E 

ID 

DEC 

E 

lEyy 

LD 

E.dala 

IF 

RRA 

20  disp-2 

JR 

NZ.disp 

21  wvy 

LD 

HL.datatf 

22  ppqq 

LD 

(addrl.HL 

23 

INC 

HL 

24 

INC 

H 

25 

DEC 

H 

26  w 

LD 

H,data 

27 

DAA 

28  disp-2 

JR 

Z,disp 

29 

ADD 

HL,HL 

2A  ppqq 

LD 

HL.iaddr) 

28 

DEC 

HL 

2C 

INC 

L 

2D 

DEC 

L 

2E 

LD 

L,data 

2F 

CPL 

30  disp-2 

JR 

NCdisp 

31  yyyy 

LD 

SP.data16 

32  ppqq 

LD 

(addrl.A 

33 

INC 

SP 

34 

INC 

(HL) 

35 

DEC 

(HL) 

36  yy 

LD 

(HU,data 

37 

SCF 

38 

JR 

Cdisp 

OBJECT  CODE 

INSTRUCTION 

39 

ADD 

HL.SP 

3A  ppqq 

LD 

A,(addrl 

38 

DEC 

SP 

3C 

INC 

A 

3D 

DEC 

A 

3Eyy 

LD 

A.data 

3F 

CCF 

4  Osss 

LD 

B.reg 

46 

LD 

B.IHLi 

4  Isss 

LD 

C.reg 

4E 

LD 

C,(HU 

5  Osss 

LD 

D.reg 

56 

LD 

D,(HL) 

5  Isss 

LD 

E,reg 

5E 

LD 

E,(HU 

6  Osss 

LD 

H.reg 

66 

LD 

H.(HL) 

6  Isss 

LD 

L.reg 

6E 

LD 

L,(HU 

7  Osss 

LD 

(HD.reg 

76 

HALT 

7  Isss 

LD 

A.reg 

7E 

LD 

A,(HL) 

8  OnT 

ADD 

A.reg 

86 

ADD 

A.IHU 

8  1nT 

ADC 

A.rog 

8E 

ADC 

A,(HL) 

9  Orrr 

SUB 

rag 

96 

SUB 

(HL) 

9  1rrr 

SBC 

A.reg 

9E 

SBC 

A.IHU 

A  Orrr 

AND 

rag 

A6 

AND 

(HU 

A  Irrr 

XOR 

rag 

AE 

XOR 

(HU 

B  Orrr 

OR 

rag 

86 

OR 

(HU 

B  1rrr 

CP 

rag 

BE 

CP 

(HU 

CO 

RET 

NZ 

CI 

POP 

BC 

C2  ppqq 

JP 

NZ.addi 

C3  ppqq 

JP 

addr 

C4  ppqq 

CALL 

NZ.addr 

C5 

PUSH 

BC 

C6  yy 

ADD 

A,data 

C7 

RST 

OOH 

C8 

RET 

Z 

09 

RET 

CA  ppqq 

JP 

Z.addr 

CB  0  Orrr 

RLC 

rag 

C8  06 

RLC 

(HU 

CB  0  Irrr 

RRC 

rag 

CBOE 

RRC 

(HU 

CB  1  Orrr 

RL 

rag 

CB  16 

RL 

(HU 

CB  1  Irrr 

RR 

rag 

3-40 


Table  3-5. 

Instruction  Object  Codes 

n  Numerical  Order  (Continued) 

OBJECT  CODE 

INSTRUCTION 

OBJECT  CODE 

INSTRUCTION 

CB  1E 

RR 

(HLI 

OD  CB  disp  lObbbllO 

RES 

b,(IX  +  disp) 

CB  2  Orrr 

SLA 

rea 

DD  CB  disp  llbbbllO 

SET 

b,dX  +  disp) 

CB  26 

SUi 

IHLI 

DD  El 

POP 

IX 

CB  2  Irrr 

SRA 

reg 

DD  E3 

EX 

(SP).IX 

CB  2E 

SRA 

(HL) 

DD  E5 

PUSH 

IX 

CB  3  Irrr 

SRL 

reg 

DD  E9 

JP 

(IX) 

CB  3S 

SRL 

(HU 

DD  F9 

LD 

SP.IX 

CB  Olbbbrrr 

BIT 

b.rag 

DEyy 

SBC 

A.  data 

CB  OlbbbllO 

BIT 

b,(HU 

OF 

RST 

t8H 

CB  lObbbrrr 

RES 

b.reg 

EO 

RET 

PO 

CB  10bbb110 

RES 

b.lHL) 

El 

POP 

HL 

CB  Hbbbrrr 

SET 

b.reg 

E2  ppqq 

JP 

PO.addr 

CB  1 tbbbllO 

SET 

b,(HU 

E3 

EX 

(SP),HL 

CC  ppqq 

CALL 

Z.addr 

E4  ppqq 

CALL 

PO.addr 

CD  ppqq 

CALL 

addr 

ES 

PUSH 

HL 

CE  yy 

ADC 

A.data 

66  yy 

AND 

data 

CF 

RST 

08H 

E7 

RST 

20H 

DO 

RET 

NC 

E8 

RET 

PE 

Dl 

POP 

OE 

E9 

JP 

(HU 

02  ppqq 

JP 

NC.addr 

EA  ppqq 

JP 

PE.addr 

D3  yy 

OUT 

(port).A 

EB 

EX 

OEHL 

04  ppqq 

CALL 

NC.addr 

EC  ppqq 

CALL 

PE.addr 

D5 

PUSH 

OE 

ED  OldddOOO 

IN 

reg,(C) 

D6  yy 

SUB 

data 

ED  OlsssOOl 

OUT 

(O.reg 

D7 

RST 

lOH 

ED  Olxx  2 

SBC 

HL.rp 

08 

RET 

C 

ED  01 XX  3  ppqq 

LD 

(addr),rp 

D9 

EXX 

ED  44 

NEG 

OA  ppqq 

JP 

C.addr 

ED  46 

RETN 

OB  yy 

IN 

A.fport) 

ED  OlOnnllO 

IM 

m 

DC  ppqq 

CALL 

C.addr 

ED  47 

LD 

I.A 

DD  OOxx  9 

ADD 

IX.PP 

ED  01xx  A 

ADC 

HL.rp 

DO  21  yyyy 

LD 

IX.dataie 

ED  01xx  B  ppqq 

LD 

rp.(addr) 

DD  22  ppqq 

LD 

(addrUX 

ED  40 

RETI 

DD  23 

INC 

IX 

ED  4F 

LD 

R.A 

DD  2A  ppqq 

LD 

IX.(addrl 

ED  57 

LO 

A.I 

00  2B 

DEC 

IX 

ED  SF 

LD 

A.R 

DD  34  disp 

INC 

(IX  +  disp) 

ED  67 

HRO 

OD  35  disp 

DEC 

(IX  +  dispi 

EO  6F 

RLD 

DD  36  disp  yy 

LD 

(IX  +  dispi.data 

ED  AO 

LOI 

DD  mddd1 10  disp 

LD 

rsg.dX  +  dispi 

ED  A1 

CPI 

DD  '  Osss  disD 

LD 

(IX  +  displreg 

ED  A2 

INI 

00  86  disp 

ADD 

A.dX  +  disp) 

ED  A3 

OUTI 

00  8E  disp 

ADC 

A.dX  +  disp) 

EO  A8 

LDD 

00  96  disp 

SUB 

(IX  +  disp) 

ED  A9 

CPD 

00  9E  disp 

SBC 

A.dX  +  disp) 

EO  AA 

iND 

DD  A6  disp 

AND 

dX  +  disp) 

ED  AB 

OUTD 

DD  AE  disp 

XOR 

(IX  +  disp) 

ED  BO 

LDIR 

UU  DO  UiSP 

OR 

dX  +  disp) 

ED  Bt 

CPIR 

DD  BE  disp 

CP 

(IX  +  disp) 

ED  B2 

INIR 

UU  UD  ujsp  Ub 

RLC 

(IX  +  disp) 

ED  B3 

OTIR 

00  CB  disp  OE 

RRC 

dX  +  disp) 

EO  B8 

LDDR 

OD  CB  disp  16 

RL 

(IX  +  disp) 

EO  B9 

CPDR 

DD  CB  disp  1E 

RR 

(IX  +  disp) 

ED  BA 

INOR 

DD  CB  disp  26 

SLA 

(IX  +  disp) 

ED  BB 

OTDR 

DD  CB  disp  2E 

SRA 

(IX  +  disp) 

EEyy 

XOR 

data 

DD  CB  disp  3E 

SRL 

(IX  +  disp) 

EF 

RST 

28H 

DD  CB  disp  OlbbbllO 

BIT 

b.dX  +  disp) 

3-41 


Table  3-5.  Instruction  Object  Codes  in  Numerical  Order  (Continued) 


OBJECT  CODE 

INSTRUCTION 

FO 

RET 

P 

F1 

POP 

AF 

F2  ppqq 

JP 

P.addr 

F3 

Dl 

F4  ppqq 

CALL 

P.addr 

F5 

PUSH 

AF 

F6  w 

OR 

data 

F7 

RST 

30H 

F8 

RET 

M 

F9 

LD 

SP.HL 

FA  ppqq 

JP 

M.addr 

FB 

El 

FC  ppqq 

CALL 

M.addr 

FDOOxx  9 

ADD 

lY.rr 

FD  21  yyw 

LD 

!Y,datal6 

FD  22  ppqq 

LD 

(addrl.lY 

FD  23 

INC 

lY 

FD  2A  ppqq 

LD 

lY.laddrt 

FD  2B 

DEC 

lY 

FD  34  disp 

INC 

(lY  +  displ 

FD  35  disp 

DEC 

(lY  +  disp) 

FD  36  disp  w 

LD 

(lY  +  disp).data 

FDOlddd  110  disp 

LD 

reg,(IY  +  disp) 

FD  7  Osss  disp 

LD 

(lY  +  displ.reg 

FD  86  disp 

ADD 

A.dY  +  dlspi 

INSTRUCTION 

FD  BE  disp 

ADC 

A,(IY+displ 

FD  96  disp 

SUB 

(lY  +  displ 

FD  9E  disp 

SBC 

A,IIY  +  disp) 

FD  A6  disp 

AND 

(lY  +  dispi 

FD  AE  disp 

XOR 

(lY  +  disp) 

FD  B6  disp 

OR 

IIY  +  disp) 

FD  BE  disp 

CP 

(lY  +  dispi 

FD  CB  disp  06 

RLC 

(lY  +  displ 

FD  CB  disp  OE 

RRC 

(lY  +  dispi 

FD  CB  disp  16 

RL 

(lY  +  disp) 

FD  CB  disp  IE 

RR 

(lY+disp) 

FO  CB  disp  26 

SLA 

NY  +  disp) 

FD  CB  disp  2E 

BRA 

(lY  +  displ 

FD  CB  disp  3E 

SRL 

(lY  +  dispi 

FDCBdispOlbbbllO 

P,UT  T  Qisp; 

FDCBdisp  lObbbllO 

RES 

b.dY  +  displ 

rU       dtSP  llbDDllU 

SET 

b.llY  +  disp) 

FDE1 

POP 

lY 

FD  E3 

EX 

ISPl.lY 

FD  E5 

PUSH 

lY 

FDE9 

JP 

(lY) 

FDF9 

LD 

SP.IY 

FEW 

CP 

data 

FF 

RST 

38H 

■42 


ADC  A,data  — ADD  IMMEDIATE  WITH  CARRY  TO 
ACCUMULATOR 


ADC  A.  data 
CE  yv 

Add  the  contents  of  the  next  program  memory  byte  and  the  Carry  status  to  the  Ac- 
cumulator. 

Suppose  xx=3Ai6.  vy=7Ci6.  and  Carrv=0.  After  the  instruction 

ADC  A,7CH 

has  executed,  the  Accumulator  will  contain  B6ig; 

3A  =  0  0  1  1      10  10 


7C 
Carry 


0  111 


1100 
0 


1  sets  S  to  1 
No  carry,  set  C  to  0" 


1 


Oil  0110 


0V1=1,  set  P/0  to  1 


Non-zero  result,  set  Z  to  0 
-Carry,  set  Ac  to  1 
Addition  instruction,  set  N  to  0 


The  ADC  instruction  Is  frequently  used  in  multibyte  addition  for  the  second  and  subse- 
quent bytes. 
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ADC  A,reg 


S    Z  Ac  P/O  N  C 

1x|x|x|x|o|xi 


■  ADD  REGISTER  WITH  CARRY  TO 
ACCUMULATOR 


Data 
Memory 


Program 
Memory 


lOOOIxxx 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  3 


reg 

XXX 

000 

for  reg= 

B 

001 

for  reg= 

C 

010 

for  reg= 

D 

Oil 

for  reg= 

E 

100 

for  reg= 

H 

101 

for  reg= 

L 

111 

for  reg= 

A 

Add  the  contents  of  Register  A,  B,  C.  D,  E.  H  or  L  and  the  Carry  status  to  the  Accumula- 
tor. 

Suppose  xx=E3-]5,  Register  E  contains  AO-[q.  and  Carry=1.  After  the  instruction 

ADC  A,E 

has  executed,  the  Accumulator  will  contain  84i6: 
E3  =  1  1  1  0     0  0  1  1 


AO  = 
Carry  = 


10  10 


0000 
1 


1  sets  S  to  1 
Carry,  set  C  to  1 


1.0  0  0     0  1  00 


U  i_ 


Non-zero  result,  set  Z  to  0 
No  carry,  set  Ac  to  0 
Addition  instruction,  set  N  to  0 


1  ¥-1=0,  set  P/O  to  0 

The  ADC  instruction  is  most  frequently  used  in  multibyte  addition  for  the  second  and 
subsequent  bytes. 
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ADC  A,(HL)  —  ADD  MEMORY  AND  CARRY  TO 
ADC  A,{IX+disp)  ACCUMULATOR 
ADC  A,{IY+disp> 


S   Z  Ac  P/O  N  C 
F|X|X|X|X|0  IXIK- 


A 
B,C 
D.E 
H.L 
SP 
PC 
IX 
lY 


PP 

qq 

mmmm 

ppqq 


Program 
Memory 


8E 


nrimmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  ADC  A,(HU: 

ADC  A,!HL1 
'      8E  ' 

Add  the  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register  pair) 
and  the  Carry  status  to  the  Accumulator. 

Suppose  xx=E3i6.  yv=A0i6.  and  Carry=1.  After  the  instruction 

ADC  A,!HU 

has  executed,  the  Accumulator  will  contain  84-\q: 

E3  =  1  1  1  0     0  0  1  1 
AO  =  1  0  1  0     0  0  0  0 
Carry  =  1 


1  sets  S  to  1 
Carry,  set  C  to  1 


1000     0  100 


1  ¥  1  =0,  set  P/0  to  0 


Non-zero  result,  set  Z  to  0 
No  carry,  set  A^  to  0 
Addition  instruction,  set  N  to  0 


ADC  A,(IX-l-disp) 


DD   8E  d 

Add  the  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the  IX 
register  and  the  displacement  digit  d)  and  the  Carry  to  the  Accumulator. 

ADC^/MlY+djsp) 
FD   8E  d 

This  instruction  is  identical  to  ADC  .A,(IX+disp),  except  that  it  uses  the  lY  register  in- 
stead of  the  IX  register. 

The  ADC  instruction  is  most  frequently  used  in  multibyte  addition  for  the  second  and 
subsequent  bytes. 


3-45 


ADC  HL.rp  — ADD  REGISTER  PAIR  WITH  CARRY  TO  H  AND  L 

3   Z  AcP/0  N  C 
F|X|X|X|X|0|X1 


Data 
Memory 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


XX 

XX 

mmmm 



ADC  HL,rp 


ED  01  xxl 01  0 

00  for  rp  is  register  pair  BC 

01  for  rp  is  register  pair  DE 

10  for  rp  is  register  pair  HL 

1 1  for  rp  IS  Stacl<  Pointer 

Add  the  16-bit  value  from  either  the  BC,  DE,  HL  register  pair  or  the  Stack  Pointer,  and 
the  Carry  status,  to  the  HL  register  pair. 

Suppose  HL  contains  A536i6.  BC  contains  1044i6.  and  Carry=1.  After  execution  of 

ADC  HLBC 

the  HL  register  pair  will  contain: 

A536  =  1010  0101  0011  0110 
1044  =  0001  0000  0100  0100 
Carry  =  1 


1  sets  S  to 


1-*- J 


1011  0101  0111  1011 


No  carry,  set  C  to  0-< 


0¥0=0,  set  P/OtoO 


-Non-zero  result,  set  Z  to  0 
-No  carry,  set  Aq  to  0 
Addition  instruction,  set  N  toO 


The  ADC  instruction  is  most  frequently  used  in  multibyte  addition  for  the  second  and 
subsequent  bytes. 
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ADD  A.data— ADD  IMMEDIATE  TO  ACCUMULATOR 

S    Z  Ac  P/O  N  C 
FlXlXlXlXjOtXl 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


XX 

mmmm 

Data 
Memory 


Program 
Memorv 


C6 


ADDA,  data 
C6  vy 

Add  the  contents  of  the  next  program  memory  byte  to  the  Accumulator. 
Suppose  xx=3Ai6.  yy=7Ci6.  and  Carry=0.  After  the  instruction 

ADD  A,7CH 

has  executed,  the  Accumulator  will  contain  B6-|6: 
3A  =  0  0  11      10  10 


7C 


0  111  1100 


1  sets  S  to 


1 


No  carry,  set  C  to  O- 


oil  0110 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


0-V-1=1:  set  P/O  to  1 
This  is  a  routine  data  manipulation  instruction. 


Non-zero  result,  set  Z  to  0 

Carry,  set  Ac  to  1 

Addition  instruction,  set  N  to  0 
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ADD  A.reg  —  ADD  CONTENTS  OF  REGISTER  TO 
ACCUMULATOR 


S    Z  Ac  P/O  N  C 


D,E 
H.L 
SP 
PC 
IX 
lY 


Ixlxlxlxlolxl               r,  =r 

1 

XX 

mmmm 

xx  +  yy 


contents  of 
^.B.C.D.E, 
H  or  L  Is  yy 

mmmm  + 1 


Data 
Memory 


Program 
Memory 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  3 


ADD  reg 

1 0000  XXX 
000 
001 
010 
Oil 
100 
101 
111 


for  reg=B 
for  reg=C 
for  reg=D 
for  reg=E 
for  reg=H 
for  reg=L 
for  reg=A 


Add  the  contents  of  Register  A.  B.  C,  D,  E,  H  or  L  to  the  Accumulator. 
Suppose  xx=E3i6.  Register  E  contains  AOig.  After  execution  of 

ADD  A,E 

the  Accumulator  will  contain  83ig: 

E3  =  1  1  1  0  0  0  11 
AO  =  1010  0000 


1  sets  S  to  1 
Carry,  set  C  to  1- 


1 

J 


000     00  11 


1  ¥■  1  =0,  set  P/0  to  0 
This  IS  a  routine  data  manipulation  instruction 


Non-zero  result,  set  Z  to  0 
No  carrv',  set  Ac  to  0 
Addition  instruction,  set  N  to  0 
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ADD  A,(HL)  —  ADD  MEMORY  TO  ACCUMULATOR 
ADD  A,(IX+disp) 
ADD  A,{IY+disp) 

S    Z  AcP/O  N  C 
F|X|X|X|X| 0[X| 


ppqq  +  d 


The  illustration  shows  execution  of  ADD  A,(IX+disp). 

^ADD^AjDC+disp) 

DD    86  d 

Add  the  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the  IX 
register  and  the  displacement  digit  d)  to  the  contents  of  the  Accumulator. 

Suppose  ppqq=4000-|g,  xx=1Ai6.  and  memory  location  400Fi6  contains  50i 6-  After 
the  instruction 

ADD  A.(IX+OFH) 

has  executed,  the  Accumulator  will  contain  6Aig. 

1A  =  000  1  1  0  1  0 
50  =  0101  0000 


0  sets  S  to  0 
No  carry,  set  C  to  0- 


0 

J 


110     10  10 


Non-zero  result,  set  Z  to  0 
No  carry,  set  Aq  to  0 
Addition  instruction,  set  N  to  0 


0¥0=0;  set  P/0  to  0 

^Am  A,.(IY+disp) 

FD    86  d 

This  instruction  is  identical  to  ADD  A.(!X+disp).  except  that  it  uses  the  lY  register  in 
stead  of  the  IX  register. 

ADD  A,(HL) 
86 

This  version  of  the  instruction  adds  the  contents  of  memory  location,  specified  by  the 
contents  of  the  HL  register  pair,  to  the  Accumulator. 

The  ADD  instruction  is  a  routine  data  manipulation  instruction. 
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ADD  HL.rp  — ADD  REGISTER  PAIR  TO  H  AND  L 

S   Z  AcP'O  N  C 


A 
B.C 
O.E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


XX 

XX 

mmmm 



ADD  HLrp 

7K 


00  XX  1001 

00  for  rp  is  register  pair  BC 

01  for  rp  is  register  pair  DE 

10  for  rp  is  register  pair  HL 

1 1  for  rp  is  Staci<  Pointer 

Add  the  1 6-bit  value  from  either  the  BC,  DE,  HL  register  pair  or  the  Stack  Pointer  to  the 
HL  register  pair. 

Suppose  HL  contains  034A-|g  and  BC  contains  2l4Ci6-  After  the  instruction 

ADD  HLBC 

has  executed,  the  HL  register  pair  will  contain  2496ig. 

034A  =  0000  0011  0100  1010 
214C  =  0010  0001  0100  1100 


00100100  1001  0110 


No  carry,  set  C  to  0 


-No  carry,  set  Aq  to  0 
Addition  instruction,  set  N  to  0 


The  ADD  HL.HL  instruction  is  equivalent  to  a  16-bit  left  shift. 
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ADD  xy,rp  — ADD  REGISTER  PAIR  TO  INDEX  REGISTER 

S    Z  Ac  P/O  N  C 

^1   I  |x|  |o|x3 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 
i 

R 


rr 

ss 

mmmm 

k 

ppqq 

ppqq  -f  rrss 


The  illustration  shows  execution  of  ADD  IX. DE. 

ADD  JXIP 


 0,xx  1""' 


11  y1  1101  OO.xx  1001 


Data 
Memorv 


Program 
Memorv 


11v11101 


OOxxlOOl 


mmmm 

mmmm  + 1 

mmmm  +  2 

mmmm  -f  3 


0  for  Index  register=IX    00  for  rp  is  register  pair  BC 

1  for  Index  register=lY    01  for  rp  is  register  pair  DE 

10  for  rp  is  specified  Index  register 

1 1  for  rp  is  Stack  Pointer 

Add  the  contents  of  the  specified  register  pair  to  the  contents  of  the  specified  Index 
register. 

Suppose  lY  contains  4FF0ig  and  BC  contains  OOOFie-  After  the  instruction 

ADD  lY.BC 

has  executed.  Index  Register  lY  will  contain  4FFFi6- 
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AND  data  —  AND  IMMEDIATE  WITH  ACCUMULATOR 


S   Z  Ac  P/O  N  C 


A 
B,C 
O.E 
H.L 
SP 
PC 
IX 
lY 


XX 

— ^ 

mmmm 

Data 
Memory 


Program 
Memory 


E6 


AND 
E6 


data 
VV 


AND  the  contents  of  the  next  program  memorv  byte  to  the  Accumulator. 
Suppose  xx=3Aig.  After  the  instruction 

AND  7CH 

has  executed,  the  Accumulator  will  contain  38-j6- 
3A  =  0  0  1  1      10  10 


7C  =  0  111 


1100 


0  sets  S  to  0 


— J 


00  11  1000 


I  miTtmm 

mmmm  + 1 
j  mmmm  2 

mmmm  +  3 


-Three  1  bits,  set  P/O  to  0 
-Non-zero  result,  set  Z  to  0 


This  IS  a  routine  logical  instruction;  it  is  often  used  to  turn  bits  "off"  For  example,  the 
instruction 

AND  7FH 

will  unconditionally  set  the  high  order  Accumulator  bit  to  0. 
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AND  reg  — AND  REGISTER  WITH  ACCUMULATOR 

S    Z  AqP/O  N  c 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


ixlxMlxioloi 

XX 

mmmm 

Data 
Memorv 


Program 
Memory 


10100XXX 


mmnim 
mrrimm  +  1 
mmmm  +  2 
mmmm  3 


reg 

XXX 

000 
001 
010 
011 
100 
101 
111 


for  reg=B 
for  reg=C 
for  reg=D 
for  reg=E 
for  reg=H 
for  reg=L 
for  reg=A 


AND  the  Accumulator  with  the  contents  of  Register  A.  B,  C,  D.  E,  H  or  L.  Save  the  resu  It 
in  the  Accumulator. 

Suppose  xx=E3i6.  and  Register  E  contains  AOig.  After  the  instruction 

AND  E 

has  executed,  the  Accumulator  will  contain  AOig- 

E3  =  1  1  1  0  0  0  1  1 
AO  =  1010  0000 


1  sets  S  to  1 


10  10 


0000 

/I 


-Two  1  bits,  set  P/0  to  1 
-Non-zero  result,  set  Z  to  0 


AND  is  a  frequently  used  logical  instruction. 
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AND  (HU— AND  MEMORY  WITH  ACCUMULATOR 

AND  (IX+disp) 
AND  (lY+disp) 

S   Z  Ac  P/O  N  C 

F|.xt.x..mxioj[i]l 


A 
B,C 
D,E 
H.L 
SP 
PC 
IX 
lY 


XX 

mmmm 

ppqq. 

1  

ppqq  +  d 


The  illustration  shows  execution  of  AND  (lY+disp). 

_  mo  |Y+cljsp) 
FD    A6  d 

AND  the  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the  lY 
register  and^the  displacement  digit  d)  with  the  Accumulator. 

Suppose  xx=E3-|e.  ppqq=4000i6,  and  memop/  location  400F-ig  contains  AOig-  After 
the  instruction 

AND  (lY+OFH) 

has  executed,  the  Accumulator  will  contain  AOig. 

E3  =  1  1  1  0  0  111 
AO  =  1010  0000 


1  sets  S  to 


1-41  1 


10  10  0000 


-Two  1  bits,  set  P/0  to  1 
-Non-zero  result,  set  Z  to  0 


^ANDjW+disp) 
DD    A6  d 

This  instruction  is  identical  to  AND  (lY+disp),  except  that  it  uses  the  IX  register  instead 
of  the  lY  register. 

AND  (HL) 
A6 

AND  the  contents  of  the  memory  location  (specified  by  the  contents  of  the  HL  register 
pair)  with  the  Accumulator. 

AND  is  a  frequently  used  logical  instruction. 
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BIT  b.reg  — TEST  BIT  b  IN  REGISTER  reg 


S    Z  AqP/O  N  c 
-I"lbl1|u|0|  i 


A 
B,C 
D.E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


yyyiyyyy 

mmmm 

■CD 


Data 
Memory 


Program 
Memory 


CB 


Olbbbxxx 


mmrnm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


BIT  b,  reg 

CB01  bbb  xxx. 
Bit  Tested 


Register 


0 

000 

000 

B 

1 

001 

001 

c 

2 

010 

010 

D 

3 

oil 

oil 

E 

4 

100 

100 

H 

5 

101 

101 

L 

6 

110 

111 

A 

7 

111 

Place  complement  of  indicated  register  s  specified  bit  in  Z  flag  of  F  register. 

Suppose  Register  C  contains  1110  1111.  The  instruction  BIT4,C  will  then  set  theZ  flag 
to  1.  while  bit  4  in  Register  C  remains  0.  Bit  0  is  the  least  significant  bit 
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BIT  b,(HL)  —TEST  BIT  b  OF  INDICATED  MEMORY  POSITION 
BIT  b.dX+disp) 
BIT  b,|IY+disp) 


S    Z  AqP/O  N  c 
F|u|g|1  jujO I  I 


Data 
Memorv 


B,C 
D.E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


> 

PP 

qq 

mmmm 

pp.qq 


mmmm  +  2 


Program 
Memory 


01bbb110 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  BIT  4,{HL).  Bit  0  is  the  least  significant  bit. 

BIT      b,  (HU 
CB01   bbb  110 
Bit  Tested  bbb 


0 

000 

1 

001 

2 

010 

3 

oil 

4 

100 

5 

101 

6 

110 

7 

111 

Test  indicated  bit  within  mennorv  position  specified  by  the  contents  of  Register  HL,  and 
place  bit's  complement  in  Z  flag  of  the  F  register. 

Suppose  HL  contains  4000H  and  bit  3  in  memorv  location  4000H  contains  1.  The  in- 
struction 

BIT  3,(HL) 

will  then  set  the  Z  flag  to  0,  while  bit  3  in  memory  location  4000H  remains  1. 

BIT  b,(IX+disp) 

DD  CB  d  01  bbb  110 

bbb  IS  the  same  as  in  BIT  b,  (HL) 

Examine  specified  bit  within  memory  location  indicated  by  the  sum  of  Index  Register  IX 
and  disp.  Place  the  complement  in  the  Z  flag  of  the  F  register 
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Suppose  Index  Register  IX  contains  4000H  and  bit  4  of  memory  location  4004H  is  0. 
The  instruction 

BIT  4,(IX+4H) 

will  then  set  the  Z  flag  to  1.  while  bit  4  of  memory  location  4004H  remains  0. 

BIT  b.(IY+disp) 


FD  CB  d  01  bbb  1 10 

bbb  IS  the  same  as  in  BIT  b,(HU 

This  instruction  is  identical  to  BIT  b,(IX+disp),  except  that  it  uses  the  lY  register  instead 
of  the  IX  register. 

CALL  label— CALL  THE  SUBROUTINE  IDENTIFIED  IN  THE 
OPERAND 


S  Z  Ac  P/O  N  C 
>  1 


Data 


Memory 

mm  +  3 

H 

mm 

Program 
Memorv 


CD 


qq 


xxxx-2 
xxxx- 1 
xxxx 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  3 


ppqq 

Store  the  address  of  the  instruction  following  the  CALL  on  the  top  of  the  stack:  the  top 
of  the  stack  is  a  data  memory  byte  addressed  by  the  Stack  Pointer.  Then  subtract  2 
from  the  Stack  Pointer  in  order  to  address  the  new  top  of  stack.  Move  the  16-bit  address 
contained  in  the  second  and  third  CALL  instruction  object  program  bytes  to  the  Pro- 
gram Counter.  The  second  byte  of  the  CALL  instruction  is  the  low-order  half  of  the  ad- 
dress, and  the  third  byte  is  the  high-order  byte. 

Consider  the  instruction  sequence: 

CALL  SUBR 
AND  7CH 


SUBR 

After  the  instruction  has  executed,  the  address  of  the  AND  instruction  is  saved  at  the 
top  of  the  stack.  The  Stack  Pointer  is  decremented  by  2.  The  instruction  labeled  SUBR 
will  be  executed  next. 
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CALL  condition, label  — CALL  THE  SUBROUTINE  IDENTIFIED  IN 

THE  OPERAND  IF  CONDITION  IS 
SATISFIED 

^CAUl       condition,  label, 
1 1  XXX  1 00         pp  qq 

Relevant  Flag 
Z 

z 
c 
c 

P/0 
P/0 

s 
s 

This  instruction  is  identical  to  the  CALL  instruction,  except  that  the  identified 
subroutine  will  be  called  onlv  if  the  condition  is  satisfied:  otherwise,  the  instruction  se- 
quentially following  the  CALL  condition  instruction  will  be  executed. 

Consider  the  instruction  sequence; 

CALL   ;  COND.SUBR 
^  1  condition  not  satisfied 

AND    f  7CH 

condition 
satisfied 

SUBR 
V — _  1^ 

If  the  condition  is  not  satisfied,  the  AND  instruction  will  be  executed  after  the  CALL 
COND,SUBR  instruction  has  executed.  If  the  condition  is  satisfied,  the  address  of  the 
AND  instruction  is  saved  at  the  top  of  the  stack,  and  the  Stack  Pointer  is  decremented 
by  2.  The  instruction  labeled  SUBR  will  be  executed  next. 


w  Condition 

000  NZ  Non-Zero 

001  Z  Zero 

010  NC  Non-Carry 

011  C  Carry 

100  PO  Parity  Odd 

101  PE  Parity  Even 

110  P  Sign  Positive 

111  M  Sign  Negative 
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CCF  — COMPLEMENT  CARRY  FLAG 

S    Z  AqP/O  N  C 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


CD 


Data 
Memorv 


Program 
Memorv 


3F 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


CCF 
3F 

Complement  the  Carry  flag.  No  other  status  or  register  contents  are  affected. 
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CP  data  — COMPARE  IMMEDIATE  DATA  WITH 
ACCUMULATOR 


S    Z  Ac  P/O  N  C 
F|X| X|X| X|  1  |x| 


A 
B,C 
D,E 
H.L 
SP 
PC 
IX 
lY 


XX 

mmmm 

Data 
Memory 


Program 
Memory 

_ 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmnim  +  3 


CP  data 


FE 


YV 


Subtract  the  contents  of  the  second  object  code  byte  from  the  contents  of  the  Ac- 
cumulator, treating  both  numbers  as  simple  binary  data.  Discard  the  result;  i.e..  leave 
the  Accumulator  alone,  but  modify  the  status  flags  to  reflect  the  result  of  the  subtrac- 
tion. 

Suppose  xx=E3ig  and  the  second  byte  of  the  CP  instruction  object  code  contains 
A0i6.  After  the  instruction 

CP  OAOH 

has  executed,  the  Accumulator  yyill  still  contain  E3i  g,  but  statuses  vyill  be  modified  as 
follovys: 

E3  =  1  1  1  0  0  0  1  1 
AO  =1010  0000 


0  sets  S  to  0 


No  borrow,  set  C  to  0-^— 


100     00  11 


1^1=0,  set  P/0  to  0 
Notice  that  the  resulting  carry  is  complemented. 


Non-zero  result,  set  Z  to  0 
No  borrow,  set  Ac  to  0 
Subtract  instruction,  set  N  to  1 
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CP  reg  — COMPARE  REGISTER  WITH  ACCUMULATOR 


CP 

loni 


reg 

XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  forreg=E 
100  forreg=H 

for  reg=L 
for  reg=A 


101 
111 


Subtract  the  contents  of  Register  A,  B,  C,  D,  E,  H  or  L  from  the  contents  of  the  Ac- 
cumulator, treating  both  numbers  as  simple  binary  data.  Discard  the  result;  i.e..  leave 
the  Accumulator  alone,  but  modify  status  flags  to  reflect  the  result  of  the  subtraction. 

Suppose  xx=E3i6  and  Register  B  contains  AOig.  After  the  instruction 

CP  B 

has  executed,  the  Accumulator  will  still  contain  E3i  g,  but  statuses  will  be  modified  as 
follows: 

E3  =  1  1  1  0  0  0  1  1 
AO  =  1010  GOOD 


0  sets  S  to  0 
No  borrow,  set  C  to  O- 


100     00  11 


1  V- 1  =0,  set  P/0  to  0 
Notice  that  the  resulting  carry  is  complemented. 


Non-zero  result,  set  Z  to  0 
No  borrow,  set  Ac  to  0 
Subtract  instruction,  set  N  to  1 
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CP  (HL)  —  COMPARE  MEMORY  WITH  ACCUMULATOR 
CP  (IX+disp) 
CP  (lY+disp) 


S   Z  AcP'O  N  c 
F  i  X  I  X  I  X  I  X  1  1  I  X  i 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


XX 

PP 

qq 

mmmm 

ppqq 


The  illustration  shows  execution  of  CP  (HL): 

CP  (HL) 
BE 

Subtract  the  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register 
pair)  from  the  contents  of  the  Accumulator,  treating  both  numbers  as  simple  binan/ 
data.  Discard  the  result;  i.e..  leave  the  Accumulator  alone,  but  modify  status  flags  to 
reflect  the  result  of  the  subtraction. 

Suppose  xx=E3ig  and  yv=A0i5.  After  execution  of 

CP  (HL) 

the  Accumulator  will  still  contain  E3ig.  but  statuses  will  be  modified  as  follows: 

E3  =  1  1  1  0  0  0  1  1 
AO  =  0110  0000 


0  sets  S  to  0 
No  borrow,  set  C  to  0- 


0 


100     00  11 


1  ¥■  1  =0.  set  P/0  to  0 
Notice  that  the  resulting  carry  is  complemented. 

CPjlX+dis£) 

DD  BE  d 


Non-zero  result  set  Z  to  0 
No  borrow,  set  Aq  to-0 
Subtract  instruction,  set  N  to  1 
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Subtract  the  contents  of  mennory  location  (specified  by  the  sum  of  the  contents  of  the 
IX  register  and  the  displacement  value  d)  from. the  contents  of  the  Accumulator,  treat- 
ing both  numbers  as  simple  binary  data.  Discard  the  result:  i.e.,  leave  the  Accumulator 
alone,  but  modify  status  flags  to  reflect  the  result  of  the  subtraction. 

CPjIY+disp) 
FD  BE  d 

This  instruction  is  identical  to  CP  (IX+disp),  except  that  it  uses  the  lY  register  instead  of 
the  IX  register. 


CPD  — COMPARE  ACCUMULATOR  WITH  MEMORY. 

DECREMENT  ADDRESS  AND  BYTE  COUNTER 


mmmm  +  2 
mmmm  +  3 


CPD 
ED  A9 

Compare  the  contents  of  the  Accumulator  with  the  contents  of  memory  location 
(specified  by  the  HL  register  pair).  If  A  is  equal  to  memory,  set  Z  flag.  Decrement  the  HL 
and  BC  register  pairs.  (BC  is  used  as  the  Byte  Counter.) 
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Suppose  xx=E3i6.  ppqq=4000i6.  BC  contains  0001  ig.  an<J  VV=A0i6-  After  the  in- 
struction 

CPD 

has  executed,  the  Accumulator  will  still  contain  ES^g,  but  statuses  will  be  modified  as 
follows: 

E3  =  1  1  1  0  0  0  1  1 
AO  =  1010  0000 


0  100     00  11 
0  sets  S  to  0-^ — '      kS-^        I  Non-zero  result,  set  Z  to  0 


1^ 

'  No  borrow,  set  Aq  to  0 


The  P/0  flag  will  be  reset 
because  BC-1=0 

Subtract  instruction  Involved, 
set  N  to  1 

Carry  not  affected. 

The  HL  register  pair  will  contain  3FFFig,  and  BC=0. 

CPDR  —  COMPARE  ACCUMULATOR  WITH  MEMORY. 

DECREMENT  ADDRESS  AND  BYTE  COUNTER. 
CONTINUE  UNTIL  MATCH  IS  FOUND  OR  BYTE 
COUNTER  IS  ZERO 

CPDR 
ED  B9 

This  instruction  is  identical  to  CPD.  except  that  it  is  repeated  until  a  match  is  found  or 
the  byte  counter  is  zero.  After  each  data  transfer,  interrupts  will  be  recognized  and  two 
refresh  cycles  will  be  executed. 

Suppose  the  HL  register  pair  contains  5000ig,  the  BC  register  pair  contains  OOFF-]g, 
the  Accumulator  contains  F9i6.  and  memory  has  contents  as  follows: 

Location  Contents 

500016  AAie 

4FFF16  BCie 

4FFE16  1916 

4FFD16  7Ai6 

4FFC16  F9i6 

4FFB16  DDI  6 


After  execution  of 


CPDR 


the  P./O  flag  will  be  1.  the  Z  flag  will  be  1,  the  HL  register  pair  will  contain  4FFBig,  and 
the  BC  register  pair  will  contain  OOFAig. 
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CPI  — COMPARE  ACCUMULATOR  WITH  MEMORY. 
DECREMENT  BYTE  COUNTER. 
INCREMENT  ADDRESS 


CPi 
ED  A1 

Compare  the  contents  of  the  Accumulator  with  the  contents  of  memory  location 
(specified  by  the  HL  register  pair).  If  A  is  equal  to  memory,  set  the  Z  flag.  Increment  the 
HL  register  pair  and  decrement  the  BC  register  pair  (BC  is  used  as  Byte  Counter). 

Suppose  xx=E3-)g,  ppqq=4000ig,  BC  contains  0032ig,  and  vy=E3ig.  After  the  in- 
struction 

CPI 

has  executed,  the  Accumulator  will  still  contain  ESig^  but  statuses  will  be  modified  as 
follows'. 

E3  =  1  1  1  1  0  0  11 
-E3  =  0  0  0  0     110  1 


0  sets  S  to  0 


0000  0000 

t  


Result  IS  0,  set  Z  to  1 

-No  borrow,  set  Aq  to  0 

The  P/0  flag  will  be  set 
because  BC-1  *  0. 


Subtract  instruction  inyolyed, 
set  N  to  1. 


Carry  not  affected. 
The  HL  register  pair  will  contain  4001  ig'  3nd  BC  will  contain  0031  ig. 
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CPIR  — COMPARE  ACCUMULATOR  WITH  MEMORY. 
DECREMENT  BYTE  COUNTER. 
INCREMENT  ADDRESS. 
CONTINUE  UNTIL  MATCH  IS  FOUND 
OR  BYTE  COUNTER  IS  ZERO 

CPIR 

ED  Bl 

This  instruction  is  identical  to  CPI,  except  that  it  is  repeated  until  a  match  is  found  or 
the  byte  counter  is  zero.  After  each  data  transfer  interrupts  will  be  recognized  and  two 
refresh  cvcles  will  be  executed. 

Suppose  the  HL  register  pair  contains  4500-|6.  the  BC  register  paif  contains  OOFFig, 
the  Accumulator  contains  F9ig,  and  memory  has  contents  as  follows: 

Location  Contents 
4500^6  AA16 
45OI16  15i6 
450216  F9i6 

After  execution  of 

CPIR 

the  P/0  flag  will  be  1,  and  the  Z  flag  will  be  1.  The  HL  register  pair  will  contain  4503i  g, 
and  the  BC  register  pair  will  contain  OOFC-|g. 
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CPL  — COMPLEMENT  THE  ACCUMULATOR 


S    Z  Ac  P/O  N  C 

in 


Data 
Memory 


Program 
Memory 


2F 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


CPL 


Complement  the  contents  of  the  Accumulator.  No  other  registers  contents  are 
affected. 

Suppose  the  .Accumulator  contains  3Aig.  After  the  instruction 

CPL 

has  executed,  the  Accumulator  will  contain  C5i6- 

3A  =  0  0  1  1      10  10 
Complement  =  11  00  0101 

This  IS  a  routine  logical  instruction.  You  need  not  use  it  for  binary  subtraction;  there  are 
special  subtract  instructions  (SUB,  SBC). 
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DAA  — DECIMAL  ADJUST  ACCUMULATOR 


S   Z  Ac  P/O  N  C 

f|x|x|x|x|  |x| 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


Data 
Memorv 


Program 
Memory 


27 


mmmm 
mmmm  +  1 
mmmm  2 
mmmm  +  3 


DAA 


27 


Convert  the  contents  of  the  Accumulator  to  binary-coded  decimal  form.  This  instruc- 
tion should  only  be  used  after  adding  or  subtracting  two  BCD  numbers;  i.e..  look  upon 
ADD  DAA  or  ADC  DAA  or  INC  DAA  or  SUB  DAA  or  SBC  DAA  or  DEC  DAA  or  NEG  DAA 
as  compound,  decimal  arithmetic  instructions  which  operate  on  BCD  sources  to  gener- 
ate BCD  answers. 

Suppose  the  Accumulator  contains  39ig  and  the  B  register  contains  47i@.  After  the  in- 
structions 

ADD  B 
DAA 

have  executed,  the  Accumulator  will  contain  86-]  g.  not  80ig. 

Z80  CPU  logic  uses  the  values  in  the  Carry  and  Auxiliary  Carry,  as  well  as  the  Ac- 
cumulator contents,  in  the  Decimal  Adjust  operation. 
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DEC  reg  —  DECREMENT  REGISTER  CONTENTS 


S   Z  AqP/O  n  c 


DEC  reg 


00    XXX  101 


000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

01 1  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Subtract  1  from  the  contents  of  the  specified  register. 

Suppose  Register  A  contains  50-|g.  After  execution  of 

DEC  A 

Register  A  will  contain  4Fig. 
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DEC  rp  - 
DEC  IX 
DEC  lY 

S    Z  Ac  P/O  N  C 


DECREMENT  CONTENTS  OF  SPECIFIED  REGISTER 
PAIR 


The  illustration  shows  execution  of  DEC  rp: 

DEC  jp_ 

00  XX  1011 

00  for  rp  IS  register  pair  BC 

01  for  rp  IS  register  pair  DE 

10  for  rp  IS  register  pair  HL 

1 1  for  rp  IS  Stack  Pointer 

Subtract  1  from  the  1 6-bit  value  contained  in  the  specified  register  pair.  No  status  flags 
are  affected. 

Suppose  the  H  and  L  registers  contain  2F00-j6.  After  the  instruction 

DEC  HL 

has  executed,  the  H  and  L  registers  will  contain  2EFF-]g. 

DEC  IX 
DD  2B 

Subtract  1  from  the  16-bit  value  contained  in  the  IX  register. 

DEC  lY 
FD^ 

Subtract  1  from  the  16-bit  value  contained  in  the  lY  register. 

Neither  DEC  rp.  DEC  IX  nor  DEC  lY  affects  any  of  the  status  flags.  This  is  a  defect  in  the 
Z80  instruction  set,  inhented  from  the  8080.  Whereas  the  DEC  reg  instruction  is  used  in 
Iterative  instruction  loops  that  use  a  counter  with  a  value  of  256  or  less,  the  DEC  rp 
(DEC  IX  or  DEC  lY)  instruction  must  be  used  if  the  counter  value  is  more  than  256.  Since 
the  DEC  rp  instruction  sets  no  status  flags,  other  instructions  must  be  added  to  simply 


3-70 


test  for  a  zero  result.  This  is  a  typical  loop  form; 

LD  DE.DATA    :LOAD  INITIAL  16-BIT  COUNTER  V.ALUE 

LOOP       -  :FIRST  INSTRUCTION  OF  LOOP 


DEC  DE 

LD  A,D 

OR  E 

JP  NZ.LOOP 


DECREMENT  COUNTER 

TO  TEST  FOR  ZERO,  MOVE  D  TO  A 

THEN  OR  A  WITH  E 

RETURN  IF  NOT  ZERO 


DEC  (HL)  —  DECREMENT  MEMORY  CONTENTS 
DEC  (IX+disp) 
DEC  (lY+disp) 

S   Z  Ac  P/O  N  C 
Flxixlxlxhll 


A 
B,C 
D,E 
H,L 
SP 
PC 
IX 
lY 


pp 

qq 

rr^mmm 

The  illustration  shows  execution  of  DEC  (HL): 

DEC  (HL) 

35 

Subtract  1  from  the  contents  of  memory  location  (specified  by  the  contents  of  the  HL 
register  pair). 

Suppose  ppgq=4500ig,  yv=5Fi5.  After  execution  of 

DEC  (HL) 

memory  location  4500ig  will  contain  5Eig. 

5F  =  0  1  0  1  1111 
-01    =   1  1  1  1  1111 


0  sets  S  to  0 


10  1  1110 


1     1  =0,  set  P/O  to  0 


\  


Non-zero  result,  set  Z  to  0 
No  borrow,  set  Aq  to  0 
Subtract  instruction,  set  N  to  1 
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^^DECjlX+disp) 
DD  35  d 

Subtract  1  from  the  contents  of  memory  location  (specified  by  the  sum  of  the  contents 
of  the  IX  register  and  the  displacement  value  d). 

^  DEC  (lY+djsp) 

FD  35  d 

This  instruction  is  identical  to  DEC  (IX+disp),  except  that  it  uses  the  lY  register  instead 
of  the  IX  register. 

Dl  —  DISABLE  INTERRUPTS 


Z  Ac  P/0  N  C 

rrrm 


A 
B,C 
D.E 
H.L 
SP 
PC 
IX 
lY 


Data 
Memory 


Program 
Memory 

F3 


mmmm 
mmmm  -f  1 
mmmm  +  2 
mmmm  +  3 


When  this  instruction  is  executed,  the  maskable  interrupt  request  is  disabled  and  the 
INT  input  to  the  CPU  will  be  ignored.  Remember  that  when  an  interrupt  is 
acknowledged,  the  maskable  interrupt  is  automatically  disabled. 

The  maskable  interrupt  request  remains  disabled  until  it  is  subsequently  enabled  by  an 
El  instruction. 

No  registers  or  flags  are  affected  by  this  instruction. 
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DJNZ  disp  — JUMP  RELATIVE  TO  PRESENT 

CONTENTS  OF  PROGRAM  COUNTER  IF 
REG  B  IS  NOT  ZERO 


Data 
Memory 


Program 


Memorv 

10 

dd-2 

mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


DJNZ  disp 
10  dd-2 

Decrement  Register  B.  If  remaining  contents  are  not  zero,  add  the  contents  of  the  DJNZ 
instruction  object  code  second  byte  and  2  to  the  Program  Counter.  The  lump  is 
measured  from  the  address  of  the  instruction  operation  code,  and  has  a  range  of  -1 26  to 
+  129  bytes.  The  .Assembler  automatically  adjusts  for  the  twice-incremented  PC. 

If  the  contents  of  B  are  zero  after  decrementing,  the  next  sequential  instruction  is  ex- 
ecuted. 

The  DJNZ  instruction  is  extremely  useful  for  any  program  loop  operation,  since  the  one 
instruction  replaces  the  typical  "decrement-then-branch  on  condition"  instruction  se- 
quence. 


El  —  ENABLE  INTERRUPTS 

S    Z  Ac  P/O  N  C 


A 
B,C 
D,E 
H,L 
SP 
PC 
IX 
lY 


Data 
Memory 


Program 
Memorv 


FB 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 
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El 


FB 

Execution  of  this  instruction  causes  interrupts  to  be  enabled,  but  not  until  one  more  in- 
struction executes. 

Most  interrupt  service  routines  end  with  the  two  instructions; 

El  lENABLE  INTERRUPTS 

RET  ;RETURN  TO  INTERRUPTED  PROGRAM 

If  interrupts  are  processed  serially,  then  for  the  entire  duration  of  the  interrupt  service 
routine  all  maskable  interrupts  are  disabled  —  which  means  that  in  a  multi-interrupt 
application  there  is  a  significant  possibility  for  one  or  more  interrupts  to  be  pending 
when  any  interrupt  service  routine  completes  execution. 

If  interrupts  were  acknowledged  as  soon  as  the  El  instructions  had  executed,  then  the 
Return  instruction  would  not  be  executed.  Under  these  circumstances,  returns  would 
stack  up  one  on  top  of  the  other  — and  unnecessarily  consume  stack  memory  space. 
This  may  be  illustrated  as  follows: 

Interrupt 


Interrupt  service  routine 


By  inhibiting  interrupts  for  one  more  instruction  following  execution  of  El,  the  Z80  CPU 
ensures  that  the  RET  instruction  gets  executed  in  the  sequence; 


El 

RET 


;ENABLE  INTERRUPTS 

;  RETURN  FROM  INTERRUPT 


It  IS  not  uncommon  for  interrupts  to  be  kept  disabled  while  an  interrupt  service  routine 
is  executing.  Interrupts  are  processed  serially: 


Interrupt 


Interrupt 


Interrupt  service  routine 


Interrupt  service  routine 
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EX  AF,AF'  —  EXCHANGE  PROGRAM  STATUS  AND  ALTERNATE 
PROGRAM  STATUS 

S    Z  Ac  P/O  N  C 

I  I  I  I  I  I 


EX  AF.AF 
08 

The  two-byte  contents  of  register  pairs  AF  and  A'F'  are  exchanged. 
Suppose  AF  contains  4F99ig  and  A'F'  contains  lOAAig.  After  execution  of 

EX  AF.AF' 

AF  will  contain  lOAAig  and  AF'  will  contain  4F99i6. 
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EX  DE,HL  — EXCHANGE  DE  AND  HL  CONTENTS 

c 

1 


S    Z  Ac  P/0  N  C 


A 
B.C 
D,E 
HX 
SP 
PC 
IX 
lY 
I 

R 


PP 

qq 

XX 

vv 

^  ' 

mmmm 

Data 
Memorv 


Program 
Memory 


EB 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


EX  DE.HL 
EB 

The  D  and  E  registers'  contents  are  swapped  with  the  H  and  L  registers'  contents. 
Suppose  pp=03iQ,  qq=2Ai6,  xx=41     and  vy=FCi6-  After  the  instruction 

EX  DE.HL 

has  executed.  H  will  contain  03ig,  L  will  contain  2Ai6-  D  will  contain  41  ig  and  E  will 

contain  FCig- 

The  two  instructions: 

EX  DE.HL 
LD  A.fHL) 

are  equivalent  to: 

LD  A,(DE) 

but  if  you  want  to  load  data  addressed  by  the  D  and  E  register  into  the  B  register. 

EX  DE.HL 


LD  B,(HL) 


has  no  single  instruction  equivalent. 
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EX  (SP),HL 
EX  (SP),IX 
EX  (SP).IY 


EXCHANGE  CONTENTS  OF  REGISTER  AND 
TOP  OF  STACK 


S    Z  Ac  P/O  N  C 

1  I  I  I  M  I 


B.C 


H.L 
SP 


Data 
Memorv 


qq 


pp 


Program 
Memory 


E3 


ssss 
ssss  +  1 
ssss  +  2 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  EX  (SP),HL. 

EX  (SP),HL 
E3 

Exchange  the  contents  of  the  L  register  with  the  top  stack  byte.  Exchange  the  contents 
of  the  H  register  with  the  byte  below  the  stack  top. 

Suppose  xx=21i6.  yy=FAi6-  PP=3Aig.  qq=E2i6.  After  the  instruction 

EX  (SPl.HL 

has  executed,  H  will  contain  SA-je.  L  will  contain  E2i6  and  the  two  top  stack  bytes  will 
contain  FAig  and  21  ig  respectively. 

The  EX  (SPl.HL  instruction  is  used  to  access  and  rnanipulate  data  at  the  top  of  the  stack. 

EX  (SP),IX 
DD  E3 

Exchange  the  contents  of  the  IX  register's  low-order  byte  with  the  top  stack  byte.  Ex- 
change the  IX  register's  high-order  byte  with  the  byte  below  the  stack  top. 

EX  (SP),IY 
FD  E3 

This  instruction  is  identical  to  EX  (SP),IX,  but  uses  the  lY  register  instead  of  the  IX 
register. 
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EXX  —  EXCHANGE  REGISTER  PAIRS  AND  ALTERNATE 
REGISTER  PAIRS 


S    Z  Ac  P/O  N  C 


Alternate 
Register  Set 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


EXX 
D9 

The  contents  of  register  pairs  BC,  DE  and  HL  are  swapped  with  the  contents  of  register 
pairs  B'C  D'E',  and  H'L' 

Suppose  register  pairs  BC,  DE  and  HL  contain  4901ig,  BFOOig  and  7251i6  respec- 
tively, and  register  pairs  B'C  D'E',  H'L'  contain  OOOOig,  lOFFig  and  3333ig  respec- 
tively. After  the  execution  of 

EXX 

the  registers  will  have  the  following  contents: 

BC;  OOOOie;  DE.  lOFFig:  HL:  3333i6; 
B'C  490116:  D'E'  SFOOig;  H'L'  7251  ig 

This  instruction  can  be  used  to  exchange  register  banks  to  provide  very  fast  interrupt 
response  times. 
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HALT 

s  z  Ac  P/o  rg  c 


A 
B.C 
D.E 
H,L 
SP 
PC 
IX 
lY 


rm 


mmmm 

Data 
Memory 


Program 
Memory 


76 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


HALT 

When  the  HALT  instruction  is  executed,  program  execution  ceases.  The  CPU  requires 
an  interrupt  or  a  reset  to  restart  execution.  No  registers  or  statuses  are  affected: 
however,  memory  refresh  logic  continues  to  operate. 
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IM  0  —  INTERRUPT  MODE  0 

S   Z  AcP/O  Nl  C 


^1     I     I     I    I     I  I 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


Data 
Memory 


Program 
Memory 


ED 


46 


mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


This  instruction  places  the  CPU  m  interrupt  mode  0.  In  this  nnode.  the  interrupting 
device  will  place  an  instruction  on  the  Data  Bus  and  the  CPU  will  then  execute  that  in- 
struction. No  registers  or  statuses  are  affected. 


fM  1  —  INTERRUPT  MODE  1 

IM  1 
ED  56 

This  instruction  places  the  CPU  in  interrupt  mode  1 .  In  this  mode,  the  CPU  responds  to 
an  interrupt  by  executing  a  restart  (RST)  to  location  0038ig, 


IM  2  —  INTERRUPT  MODE  2 

IM  2 
ED5E 

This  instruction  places  the  CPU  in  Interrupt  mode  2.  In  this  mode,  the  CPU  performs  an 
indirect  call  to  anv  specified  location  in  memory.  .A  16-bit  address  is  formed  using  the 
contents  of  the  Interrupt  Vector  (I)  register  for  the  upper  eight  bits,  while  the  lower 
eight  bits  are  supplied  by  the  interrupting  device.  Refer  to  Chapter  12  for  a  full  descrip- 
tion of  interrupt  modes.  No  registers  or  statuses  are  affected  bv  this  instruction. 
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IN  A, (port)  —  INPUT  TO  ACCUMULATOR 

S    Z  Ac  P/O  N   C  f  Data 

H     I     I     I    I     I    I  I   I/O  port  WH*. 


A 
B,C 
D.E 
H,L 
SP 
PC 
IX 
lY 
I 

R 


Program 
Memory 


DB 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


(port) 


IN  A, 
DB  yv 

Load  a  byte  of  data  into  the  Accumulator  from  the  I/O  port  (Identified  by  the  second  IN 
instruction  object  code  byte). 

Suppose  36iQ  IS  held  in  the  buffer  of  I/O  port  lAig.  After  the  instruction 

IN  A.dAH) 

has  executed,  the  Accumulator  will  contain  36ig. 
The  IN  instruction  does  not  affect  any  statuses. 

Use  of  the  IN  instruction  is  very  hardware  dependent  Valid  I/O  port  addresses  are 
determined  by  the  way  in  which  I/O  logic  has  been  implemented.  It  is  also  possible  to 
design  a  microcomputer  system  that  accesses  external  logic  using  memory  reference 
instructions  with  specific  memory  addresses. 
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INC  reg  — INCREMENT  REGISTER  CONTENTS 


INC  reg 


00  XXX  100 


000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Add  1  to  the  contents  of  tfie  specified  register. 

Suppose  Register  E  contains  A8ig.  After  execution  of 

INC  E 

Register  E  will  contain  A9-|g. 
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INC  rp- 
INC  IX 
INC  lY 


INCREMENT  CONTENTS  OF  SPECIFIED  REGISTER  PAIR 


s  z  AqP/o  n  c 

n 


The  illustration  shows  execution  of  INC  rp: 


INC  rp 


00  XX  0011 


00  for  rp  IS  register  pair  BC 

01  for  rp  IS  register  pair  DE 

10  for  rp  is  register  pair  HL 

1 1  for  rp  IS  Stack  Pointer 

Add  1  to  the  16-bit  value  contained  in  the  specified  register  pair.  No  status  flags  are 
affected. 

Suppose  the  D  and  E  registers  contain  2F7A-|g.  After  the  instruction 

INC  DE 

has  executed,  the  D  and  E  registers  will  contain  2F7Bi6- 

INC  IX 
DD  23 

Add  1  to  the  16-bit  value  contained  in  the  IX  register. 

INC  lY 

FD  23 

Add  1  to  the  16-bit  value  contained  in  the  lY  register. 

Just  like  the  DEC  rp.  DEC  IX  and  DEC  lY.  neither  INC  rp,  INC  IX  nor  INC  lY  affects  any 
status  flags.  This  is  a  defect  in  the  Z80  instruction  set  inherited  from  the  8080. 
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INC  (HL)  —  INCREMENT  MEMORY  CONTENTS 

INC  (IX+disp) 
INC  (lY+disp) 

S    Z  Ac  P/O  N  C 

Frnxixixion 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


mmmm 

Ppqq 

vy+  1 


Data 
Memory 


VV 


ppqq  +  d 


Program 
Memory 


The  illustration  shows  execution  of  INC  (IX+d): 

INC  (IX+disp) 

DD  34  d 

Add  1  to  the  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of 
Register  IX  and  the  displacement  value  d). 

Suppose  ppqq=4000ig  and  mennory  location  400Fiq  contains  36ig.  After  execution 
of  the  instruction 

INC  (IX+OFH) 

memory  location  400F-]g  will  contain  37i6- 

36  =  00  1  1     0  1  1  0 
1 


0 


0  sets  S  to  0 
Carry  status  not  affected-^-' 


Oil  0111 


Non-zero  result,  set  Z  to  0 
No  carry,  set  Aq  to  0 
Addition  instruction,  set  N  to  0 


0¥0=0,  set  P/0  to  0 

INCjIY+djsp) 

FD  34  d 

This  instruction  is  identical  to  INC  (IX+disp),  except  that  it  uses  the  lY  register  instead 
of  the  IX  register. 

INC  (HL) 
34 

Add  1  to  the  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register 
pair). 
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IND  — INPUT  TO  MEMORY  AND  DECREMENT  POINTER 


S    ZAcP/ON   C  ^^^^ 

FEEEnnn 


D.E 
H,L 
SP 
PC 
IX 
lY 
I 

R 


PP 


I/O  port  yy  | 


Data 
Memory 


Program 
Memory 


ED 


AA 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  3 


IND 
ED  AA 

Input  from  I/O  port  (addressed  by  Register  C)  to  mennorv  location  (specified  by  HL). 
Decrement  Registers  B  and  HL. 

Suppose  xx=05i6'  vv=15i6.  PpqQ=2400-|6.  and  19i6  is  held  in  the  buffer  of  I/O  port 
15-|6-  After  the  instruction 

IND 

has  executed,  memory  location  2400ig  yyiil  contain  19i6-  The  B  register  will  contain 
04-] 6  and  the  HL  register  pair  23FF-|g. 

INDR  — INPUT  TO  MEMORY  AND  DECREMENT  POINTER 
UNTIL  BYTE  COUNTER  IS  ZERO 

INDR 

ED  BA 

INDR  IS  identical  to  IND.  but  is  repeated  until  Register  B=0. 

Suppose  Register  B  contains  03i6.  Register  C  contains  15i6-  and  HL  contains  2400-]g. 
The  following  sequence  of  bytes  is  available  at  I/O  port  IBig: 


After  the  execution  of 


17ig,  59ig  and  AE-|g 


INDR 


the  HL  register  pair  will  contain  23FDig  and  Register  B  will  contain  zero,  and  memory 
locations  will  have  contents  as  follows: 

Location  Contents 


2400 
23FF 
23FE 


17ig 

5916 
AEig 


This  instruction  is  extremely  useful  for  loading  blocks  of  data  from  an  input  device  into 
memory. 
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INI  — INPUT  TO  MEMORY  AND  INCREMENT  POINTER 


S    Z  Ac  P/0  N   C  """^  ^ 

I  I  M  M  I  IT 


A 
B.C 
D.E 
H,L 
SP 
PC 
IX 
lY 


qq 


^^g»j^pqq  + 


I/O  port  vv 


Data 
Memory 


Program 
Memory 


ED 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


ED  A2 

Input  from  I/O  port  (addressed  by  Register  C)  to  memory  location  (specified  by  HL). 
Decrement  Register  B;  increment  register  pair  HL. 

Suppose  xx=05-]  6-  VV=1 5i  g,  ppqq=2400i  g,  and  1 9i  6  is  held  in  the  buffer  of  I/O  port 
1516- 

After  the  instruction 

INI 

tias  executed,  memory  location  2400-1  g  will  contain  19i6'  The  B  register  will  contain 
04ig  and  the  HL  register  pair  2401  ig. 

INIR  — INPUT  TO  MEMORY  AND  INCREMENT  POINTER 
UNTIL  BYTE  COUNTER  IS  ZERO 

INIR 

ED  B2 

INIR  IS  identical  to  INI.  but  is  repeated  until  Register  8=0. 

Suppose  Register  B  contains  OS-jg.  Register  C  contains  1 5ig.  and  HL  contains  2400-|  g. 
The  following  sequence  of  bytes  is  available  at  I/O  port  15ig: 

1  716.  59i6  and  AEig 

After  the  execution  of 

INIR 

the  HL  register  pair  will  contain  2403i  g  and  Register  B  will  contain  zero,  and  memory 
locations  will  have  contents  as  follows; 

Location  Contents 

2400  17ig 

2401  59ig 

2402  AEig 

Tfiis  instruction  is  extremely  useful  for  loading  blocks  of  data  from  a  device  into  memo- 
ry. 
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IN  reg,(C)  —  INPUT  TO  REGISTER 

S    Z  Ac  P/O  N  C 
F|X|X[0|X|0J_| 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


mmmm 

IN  reg,  iC} 


Data 
Memory 


Program 
Memory 


ED 


OlxxxOOO 


mmmm 

mmmm  + 1 

mmmm  +  2 

mmmm  -f  3 


ED  01  XXX  000 


000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

1 10  for  setting  of  status  flags  witfiout 
changing  registers 

Load  a  byte  of  data  into  the  specified  register  (reg)  from  the  I/O  port  (identified  by  the 
contents  of  the  C  register). 

Suppose  42-|g  is  held  in  the  buffer  of  I/O  port  36-]  g,  and  Register  C  contains  3615. 
After  the  instruction 

IN  D,(C) 

has  executed,  the  D  register  will  contain  42i6. 

During  the  execution  of  the  instruction,  the  contents  of  Register  B  are  placed  on  the  top 
half  of  the  Address  Bus.  making  it  possible  to  extend  the  number  of  addressable  I/O 
ports. 
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JP  label— JUMP  TO  THE  INSTRUCTION  IDENTIFIED 
IN  THE  OPERAND 


S    Z  Ac  P/O  N  C 


D,E 
H,L 
SP 
PC 
IX 
lY 


J 


mmmm 

ppqq 


Data 
Memory 


Program 


Memory 

C3 

qq 

PP 

mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


C3  ppqq 

Load  the  contents  of  the  Jump  instruction  obiect  code  second  and  third  bytes  into  the 
Program  Counter;  this  becomes  the  memory  address  for  the  next  instruction  to  be  ex- 
ecuted. The  previous  Program  Counter  contents  are  lost. 

In  the  following  sequence: 

JP  NEXT 
AND  7FH 


NEXT 


GPL 


The  GPL  instruction  will  be  executed  after  the  JP  instruction.  The  AND  instruction  will 
never  be  executed,  unless  a  Jump  instruction  somewhere  else  in  the  instruction  se- 
quence jumps  to  this  instruction. 
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JP  condition.label— JUMP  TO  ADDRESS  IDENTIFIED  IN  THE 
OPERAND  IF  CONDITION  IS 
SATISIFED 


JP  cond,  labe 


1 1  CO  010 

ppqq 

Condition 

Relevant  Flag 

000 

NZ  Non-Zero 

Z 

001 

Z  Zero 

Z 

010 

NC    No  Carry 

C 

Oil 

C  Carry 

C 

100 

PO    Parity  Odd 

P/0 

101 

PE    Parity  Even 

P/0 

110 

P      Sign  Positive 

S 

1 1 1 

M     Sign  Negative 

S 

This  instruction  is  identical  to  the  JP  instruction,  except  that  the  |ump  will  be  per- 
formed only  if  the  condition  is  satisfied:  otherwise,  the  instruction  sequentially  follow- 
ing the  JP  condition  instruction  will  be  executed. 

Consider  the  instruction  sequence 

I 
I 

J  COND.LABEL 

I  condition  not  satisfied 

I  7CH 

'^-»>LABEL      OR  B 

After  the  JP  cond. label  instruction  has  executed,  if  the  condition  is  satisfied  then  the 
OR  instruction  will  be  executed.  If  the  condition  is  not  satisfied,  the  AND  instruction, 
being  the  next  sequential  instruction,  is  executed. 


JP 


AND 

condition 
satisfied 
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JP  (HL)  —  JUMP  TO  ADDRESS  SPECIFIED  BY  CONTENTS 
JP  (IX)      OF  16-BIT  REGISTER 
JP  (lY) 


S    Z  AcP/ON   C  Data 


The  illustration  shows  execution  of  JP  (HL): 

JP  (HL) 

E9 

The  contents  of  the  HL  register  pair  are  moved  to  the  Program  Counter;  therefore,  an 
implied  addressing  )ump  is  performed. 

The  instruction  sequence 

LD  H.ADDR 
JP  (HL) 

has  exactly  the  same  net  effect  as  the  single  instruction 
JP  ADDR 

Both  specify  that  the  instruction  with  label  ADDR  is  to  be  executed  next. 

The  JP  (HL)  instruction  is  useful  when  you  want  to  increment  a  return  address  for  a 
subroutine  that  has  multiple  returns. 

Consider  the  following  call  to  subroutine  SUB: 

CALL       SUB        :CALL  SUBROUTINE 
JP  ERR         :ERROR  RETURN 

:GOOD  RETURN 

Using  RET  to  return  from  SUB  would  return  execution  of  JP  ERR:  therefore,  if  SUB  ex- 
ecutes without  detecting  error  conditions,  return  as  follows: 

POP  HL  :POP  RETURN  ADDRESS  TO  HL 

INC         HL  :ADD  3  TO  RETURN  ADDRESS 

INC  HL 
INC  HL 

JP  (HL)  :RETURN 

JP  (IX) 
DD_E9 

This  instruction  is  identical  to  the  JP  (HL)  instruction,  except  that  it  uses  the  IX  register 
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instead  of  the  HL  register  pair. 


This  instruction  is  identical  to  the  JP  (HL)  instruction,  except  that  it  uses  the  lY  register 
instead  of  the  HL  register  pair. 

JR  Cdisp  — JUMP  RELATIVE  TO  CONTENTS  OF  PROGRAM 
COUNTER  IF  CARRY  IS  SET 


This  instruction  is  identical  to  the  JR  disp  instruction,  except  that  the  |ump  is  only  ex- 
ecuted if  the  Carry  status  equals  1,  otherwise,  the  next  instruction  is  executed. 

In  the  following  instruction  sequence: 

4000       JR       I  C.$+8 
 ^ 


4002        AND    i  7FH 


— •►4008       OR  B 

After  the  JR  C,$+8  instruction,  the  OR  instruction  is  executed  if  the  Carry  status  equals 
1.  The  AND  instruction  is  executed  if  the  Carry  status  equals  0. 
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JR  disp  — JUMP  RELATIVE  TO  PRESENT  CONTENTS  OF 
PROGRAM  COUNTER 

S    Z  Ac  P/O  N  C 
F|      I     I     I     I     I  I 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


Data 
Memory 


mmmm 
Jdd 


LI  T 

Memorv 

18 

dd-2 

mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


JR  disp 
18  dd-2 

Add  the  contents  of  the  JR  instruction  object  code  second  byte,  the  contents  of  the  Pro- 
gram Counter,  and  2.  Load  the  sum  into  the  Program  Counter.  The  jump  is  measured 
from  the  address  of  the  instruction  operation  code,  and  has  a  range  of  -126  to  -H29 
bytes.  The  Assembler  automatically  adjusts  for  the  twice-incremented  PC. 

The  following  assembly  language  statement  is  used  to  jump  four  steps  forward  from  ad- 
dress 400016- 

JR  $+4 

Result  of  this  instruction  is  shown  below: 

Location  Instruction 


4000 
4001 
4002 
4003 
4004 


18 
02 


-new  PC  value 
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JR  NCdisp  — JUMP  RELATIVE  TO  CONTENTS  OF  PROGRAM 
COUNTER  IF  CARRY  FLAG  IS  RESET 


JR  NCdisp 
30  dd-2 

This  instruction  is  identical  to  the  JR  disp  instruction,  except  that  the  jump  is  only  ex- 
ecuted if  the  Carry  status  equals  0;  otherwise,  the  next  instruction  is  executed. 

In  the  following  instruction  sequence: 

A.7FH 


0=0 


-4000 

4001 
4002 
4003 


ADD 


JR 


0=1 

NC,$-3 


4005 


OR 


After  the  JR  NC.$-3  instruction,  the  OR  instruction  is  executed  if  the  Carry  status  equals 
1.  The  ADD  instruction  is  executed  if  the  Carry  status  equals  0. 


JR  NZ.disp  — JUMP  RELATIVE  TO  CONTENTS  OF  PROGRAM 
COUNTER  IF  ZERO  FLAG  IS  RESET 

JRJvJZ,disg 
20  dd-2 

This  instruction  is  identical  to  the  JR  disp  instruction,  except  that  the  junnp  is  only  ex- 
ecuted if  the  Zero  status  equals  0:  otherwise,  the  next  instruction  is  executed. 

In  the  following  instruction  sequence: 

 4000       JR      I  NZ.$-l-6 

4002  AND  X  7FH 

z=o       4004  -  fz=i 
4005 

^  »>-4006  OR  B 


After  the  JR  NZ.$-l-6  instruction,  the  OR  instruction  is  executed  if  the  Zero  status  equals 
0.  The  AND  instruction  is  executed  if  the  Zero  status  equals  1. 
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JR  Z,disp  — JUMP  RELATIVE  TO  CONTENTS  OF  PROGRAM 
COUNTER  IF  ZERO  FLAG  IS  SET 

^^Z,djsp 

28  dd-2 

This  instruction  is  identical  to  the  JR  disp  instruction,  except  that  the  |ump  is  only  ex- 
ecuted if  the  Zero  status  equals  1 ,  otherwise,  the  next  instruction  is  executed. 

In  the  following  instruction  sequence: 
4000       JR      J  Z,$+6 


4002 
4004 
4005 
-(--4006 


AND 


OR 


I  7FH 


After  the  JR  Z.$+6  instruction,  the  OR  instruction  is  executed  if  the  Zero  status  equals 
1.  The  AND  instruction  is  executed  if  the  Zero  status  equals  0. 

LD  A,l  —  MOVE  CONTENTS  OF  INTERRUPT  VECTOR  OR 
LD  A,R    REFRESH  REGISTER  TO  ACCUMULATOR 


S    2  AgP/O  N  C 
F|X|X|0|X|0|J 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


XX 

<^  ^ 

mmmm 

mmmm  *  2j 

XX 

Data 
Memory 


Program 
Memory 


ED 


57 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  LD  A.I: 

LD  A.I. 
ED  57 

Move  the  contents  of  the  Interrupt  Vector  register  to  the  Accumulator,  and  reflect  inter- 
rupt enable  status  in  Parity/Overflow  flag. 

Suppose  the  Interrupt  Vector  register  contains  7F-]6.  and  interrupts  are  disabled.  After 
execution  of 

LD  A.I 

Register  A  will  contain  7Fig.  and  P/O  will  be  0. 

LD  A,R 

ED  5F 

Moye  the  contents  of  the  Refresh  register  to  the  Accumulator.  The  value  of  the  interrupt 
flip-flop  will  appear  in  the  Parity/Overflow  flag. 
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LD  A,(addr)  —  LOAD  ACCUMULATOR  FROM  MEMORY  USING 
DIRECT  ADDRESSING 

S    Z  Ac  P/O  N  C 

M  I  I  I  I  I  I 


A 
B,C 
D.E 
H,L 
SP 
PC 
IX 
lY 


Data 
Memory 


Program 
Memory 

3A 

qq 

PP 

mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  4-  3 


J-D_A^^(addri 
3A  ppqq 

Load  the  contents  of  the  memory  byte  (addressed  directly  by  the  second  and  third 
bytes  of  the  LD  A,(addr)  instruction  object  code)  into  the  Accumulator.  Suppose  memo- 
ry byte  084A-]g  contains  20iq.  After  the  instruction 


label 


EQU 


084AH 


LD  A.dabel) 
has  executed,  the  Accumulator  will  contain  20-) g- 

Remember  that  EQU  Is  an  assembler  directiye  rather  than  an  instruction:  it  tells  the  As- 
sembler to  use  the  16-bit  value  084Aig  wherever  the  label  appears. 

The  instruction 

LD  A.dabel) 

IS  equivalent  to  the  two  instructions 

LD  HL.Iabel 
LD  .A,(HL) 

When  you  are  loading  a  single  value  from  memon/,  the  LD  A.dabel)  instruction  is  prefer- 
red; it  uses  one  instruction  and  three  object  program  bytes  to  do  what  the  LD  HL.Iabel. 
LD  A.(HL)  combination  does  in  two  instructions  and  four  object  program  bytes.  Also, 
the  LD  HLIabel,  LD  A,(HL)  combination  uses  the  H  and  L  registers,  which  LD  A.dabel) 
does  not. 
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LD  A,(rp)  —  LOAD  ACCUMULATOR  FROM  MEMORY  LOCATION 
ADDRESSED  BY  REGISTER  PAIR 


S    Z  Ac  P/O  N  C 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


»BC  or  DE  contain  ppqq 

L 


Data 
Memorv 


ppqq 


Program 
Memory 


000x1010 


mmmm  + 1 
mmmm  +  2 
mmmm  3 


LD  A,(rp) 
OOOx  1010 


0  if  register  pair=BC 

1  if  register  pair=DE 

Load  the  contents  of  the  memorv  byte  (addressed  bv  the  BC  or  DE  register  pair)  into  the 
Accumulator. 

Suppose  the  B  register  contains  08i  g,  the  C  register  contains  4Ai  g,  and  memory  byte 
084Aig  contains  SAig.  After  the  instruction 

LD  A,(BC) 

has  executed,  the  Accumulator  will  contain  3A-|g. 

Normally,  the  LD  A.(rp)  and  LD  rp.data  will  be  used  together,  since  the  LD  rp,data  in- 
struction loads  a  16-bit  address  into  the  BC  or  DE  registers  as  follows: 


LD 
LD 


BC,084AH 
A,(BC) 


3-96 


LD  dstsrc  — MOVE  CONTENTS  OF  SOURCE  REGISTER  TO 
DESTINATION  REGISTER 


S   Z  Ac  P/O  N  C 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


Register  A.  B.  C. 
D.  E.  H  or  L 

f 

Register  A.  B,  C 
'D,  E,  H,  L 


LD  dst.  sro 


Data 
Memory 


Program 
Memory 


Oldddsss 


mmmm  + 1 
mmmm  +  2 
mmmrrt  +  3 


000  for  dst  or  src=B 

001  for  dst  or  src=C 

010  for  dst  or  src=D 

01 1  for  dst  or  src=E 

100  for  dst  or  src=H 

101  for  dst  or  src=L 
111  for  dst  or  src=A 

The  contents  of  any  designated  register  are  loaded  into  any  other  register. 

For  example: 

LD  A,B 

loads  the  contents  of  Register  B  into  Register  A. 

LD  LD 

loads  the  contents  of  Register  D  into  Register  L. 

LD  C.C 

does  nothing,  since  the  C  register  has  been  specified  as  both  the  source  and  the 
destination. 
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LD  HL.Iaddr)  —  LOAD  REGISTER  PAIR  OR  INDEX  REGISTER 
LD  rp,(addr)      FROM  MEMORY  USING  DIRECT  ADDRESSING 
LD  IX,(addr) 
LD  IY,(addr) 


S    Z  Ac  P/O  N  C 

fM  I  I  I  M 


r 


B.C 
D.E 
H,L 
SP 
PC 
IX 
lY 


yy 


Data 
Memory 


ppqq 

ppqq  +  1 


Program 
Memory 


2A 


qq 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  LD  HL(ppqq): 

LD  HL.addr 
2A  ppqq 

Load  the  HL  register  pair  from  directly  addressed  memory  location. 

Suppose  memory  location  4004iq  contains  ADig  and  memory  location  4005ig  con- 
tains 12-]g.  After  the  instruction 

LD  HL,(4004H) 
has  executed,  the  HL  register  pair  will  contain  12ADig. 

LD  rp,  (addr) 


ED  01  dd  1011  ppqq 


00  for  rp  is  register  pair  BC 

01  for  rp  is  register  pair  DE 

10  for  rp  IS  register  pair  HL 

1 1  for  rp  is  Stack  Pointer 

Load  register  pair  from  directly  addressed  memory. 

Suppose  memory  location  49FFig  contains  BEig  and  memory  location  4A00ig  con- 
tains 33ig.  After  the  instruction 

LD  DE,(49FFH) 
has  executed,  the  DE  register  pair  will  contain  33BEig. 

LD  IX,(addr) 
DD  2A  ppqq 

Load  IX  register  from  directly  addressed  memory. 
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Suppose  memory  location  Dlllig  contains  FFig  and  memory  location  D112ig  con- 
tains 56iQ.  After  the  instruction 

LD  IX.(DIIIH) 

has  executed,  the  IX  register  will  contain  56FFig. 

LD  IY,(addrl 

FD  2A  ppqq 

Load  lY  register  from  directly  addressed  memory. 

Affects  lY  register  instead  of  IX.  Otherwise  identical  to  LD  IX(addr). 

LD  l,A  —  LOAD  INTERRUPT  VECTOR  OR  REFRESH 
LD  R,A    REGISTER  FROM  ACCUMULATOR 


The  illustration  shows  execution  of  LD  R.A: 

LD  R.A 

ED  4F 

Load  Refresh  register  from  Accumulator. 
Suppose  the  Accumulator  contains  7Fig.  After  the  instruction 

LD  R.A 

has  executed,  the  Refresh  register  will  contain  7F-|g. 

LD  I.A 

ED  47 

Load  Interrupt  Vector  register  from  Accumulator. 
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LD  reg.data  —  LOAD  IMMEDIATE  INTO  REGISTER 

S    Z  Ac  P/O  N   C  Data 

Memory 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


h Destination  Is 
Register  A.  B.  C,- 
D.  E,  H  or  L 


Program 
Memory 


OOxxxHO 


mmmm 

mmmm  +  1 

mmmm  +  2 

mmmm  ■+•  3 


LD  reg.data 

00  xxxllOvv 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Load  the  contents  of  tine  second  object  code  byte  into  one  of  tlie  registers. 
Wlien  tlie  instruction 

LD  A.2AH 

has  executed,  2A-\q  is  loaded  into  the  Accunnulator. 
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LD  rp.data  — LOAD  16  BITS  OF  DATA  IMMEDIATE  INTO 
LD  IX,data  REGISTER 
LD  IY,data 


S    Z  Ac  P/O  N  C 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 


\  ^  Select  BC,  DE,  Ht  or 
\ff    SP.  Load  ppqq  into 
>^ — selected  destination 

mmmm  +  3 


Data 
Memory 


Program 


The  illustration  shows  execution  of  LD  rp.data: 

LD  rp.  data 


Memory 

OOxxOOOl 

qq 

pp 

mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


00  XX  0001  ppqq 


00  for  rp  IS  register  pair  BC 

01  for  rp  is  register  pair  DE 

10  for  rp  is  register  pair  HL 

1 1  for  rp  is  Stack  Pointer 

Load  the  contents  of  the  second  and  third  object  code  bvtes  into  the  selected  register 
pair.  After  the  instruction 

LD  SP,217AH 
has  executed,  the  Stack  Pointer  will  contain  217A-|g. 

LDJX,  date 
DD  21  ppqq 

Load  the  contents  of  the  second  and  third  object  code  bytes  into  the  Index  register  IX. 

FD  21  ppqq 

Load  the  contents  of  the  second  and  third  object  code  bvtes  into  the  Index  Register  lY 
Notice  that  the  LD  rp.data  instruction  is  equivalent  to  two  LD  reg.data  instructions. 
For  example: 

LD  HL,032AH 
is  equivalent  to 


LD 
LD 


H,03H 
L,2AH 
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LD  reg,(HL)  —  LOAD  REGISTER  FROM  MEMORY 
LD  reg,(IX+clisp) 
LD  reg,(lY+disp) 

S    Z  Ac  P/O  N   C  Data 

^8111111 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
iY 


mmmm 

ppqq 

ppqq  +  d 


The  illustration  shows  execution  of  LD  reg,(IX+disp): 

LD  reg,  (IX  +  disp) 

DD01  xxxllOd 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Load  specified  register  from  nnemorv  location  (specified  by  the  sum  of  the  contents  of 
the  IX  register  and  the  displacement  digit  d). 

Suppose  ppqq=4004ig  and  memory  location  401  Oi  g  contains  FFig.  After  the  instruc- 
tion 

LD  B(1X+0CH) 
has  executed.  Register  B  will  contain  FF-|g. 

LD  reg,  (lY-l- disp) 


FD01  XXX  llOd 
I  


— ^same  as  for  LD  reg.(IX+disp) 

This  instruction  is  identical  to  LD  reg.OX+disp).  except  that  it  uses  the  IY  register  in- 
stead of  the  IX  register. 
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LD  reg,(HU 

M 

01  XXX  110 


 ^same  as  for  LD  reg,(IX+disp) 

Load  specified  register  from  memory  location  (specified  by  the  contents  of  the  HL 
register  pair). 

LD  SP,HL  —  MOVE  CONTENTS  OF  HL  OR  INDEX  REGISTER 
LD  SP,IX      TO  STACK  POINTER 
LD  SP,IY 


S  Z  Ac  P/O  N  C 
1     I    I     I     I     I  I 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


PP 

mmmm 

The  illustration  shows  execution  of  LD  SP.HL. 

LD  SP.HL 
F9 

Load  contents  of  HL  into  Stack  Pointer. 
Suppose  pp=08-|6  and  qq=3Fi6-  After  the  instruction 

LD  SP.HL 

has  executed,  the  Stack  Pointer  will  contain  O83F15. 

LD  SP.IX 

DD  F9 

Load  contents  of  Index  Register  IX  into  Stack  Pointer. 

LD  SP.IY 

FD  F9 

Load  contents  of  Index  Register  lY  into  Stack  Pointer. 


Data 
Memorv 


Program 
Memory 


F9 


mmmm 

mmmm  + 1 

mmmm  +  2 

mmmm  -f  3 
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LD  (addr),A  — STORE  ACCUMULATOR  IN  MEMORY  USING 
DIRECT  ADDRESSING 


S    Z  Ac  P/O  N  C 

-rrmm 


A 
B,C 
O.E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


yy 

mmmm 

LD  (addr),A 


Data 
Memory 


Program 
Memory 


32 


qq 


ppqq 

A 


mmmm 
mmmm  1 
mmmm  +  2 
mmmm  -f  3 


32  ppqq 


Store  the  Accumulator  contents  in  the  memory  byte  addressed  directly  by  the  second 
and  third  bytes  of  the  LD  (addrl.A  instruction  object  code. 

Suppose  the  Accumulator  contains  3A-]g.  After  the  instruction 

label        EQU  084AH 


LD  (labeli.A 
has  executed,  memory  byte  084Aig  will  contain  3Aig. 

Remember  that  EQU  is  an  assembler  directive  rather  than  an  instructioTrr  it  tells  the  As- 
sembler to  use  the  16-bit  value  084AH  whenever  the  word  "label"  appears. 

The  instruction 

LD  !addr),A 

IS  equivalent  to  the  two  instructions 

LD  H.label 
LD  (HU.A 

When  you  are  storing  a  single  data  value  in  memory,  the  LD  (label),A  instruction  is 
preferred  because  it  uses  one  instruction  and  three  object  program  bytes  to  do  what  the 
LD  H(label),  LD  (HL),A  combination  does  in  two  instructions  and  four  obiect  program 
bytes.  Also,  the  LD  H(label),  LD  (HL),A  combination  uses  the  H  and  L  registers,  while  the 
LD  (label). A  instruction  does  not. 
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LD  (addr),HL  — STORE  REGISTER  PAIR  OR  INDEX 

LD  (addr),rp      REGISTER  IN  MEMORY  USING  DIRECT 

LD  (addr),xy  ADDRESSING 


D.E 


SP 
PC 
IX 
lY 
I 

R 


Z  Ac  P/0  N  C 

I  M  M  I 


Data 
Memory 


|PPqq 

'ppqq+ 1 


Program 
Memory 


ED 


01010011 


qq 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  3 


The  illustration  shows  execution  of  LD  (ppqq),DE: 

LD  (addr),  rp 


ED  01  XX  0011  ppqq 


00  for  rp  is  register  pair  BC 

01  for  rp  is  register  pair  DE 

10  for  rp  IS  register  pair  HL 

1 1  for  rp  is  Stacl<  Pointer 

Store  the  contents  of  the  specified  register  pair  in  memorv.  The  third  and  fourth  object 
code  bytes  give  the  address  of  the  memop/  location  where  the  low-order  byte  is  to  be 
written.  The  high-order  byte  is  written  into  the  next  sequential  nnemory  location. 

Suppose  the  BC  register  pair  contains  3C2Aig.  After  the  instruction 

label    EQU  084AH 


LD  (labeD.BC 

has  executed,  memory  byte  084Aig  will  contain  2Ai  g.  Memory  byte  084B-|  g  will  con- 
tain 3Ci  6- 

Remember  that  EQU  is  an  assembler  directive  rather  than  an  instruction;  it  tells  the  As- 
sembler to  use  the  16-bit  value  084Aig  whenever  the  word  "label"  appears. 

LD  (addrl.HL 


22  ppqq 

This  is  a  three-byte  version  of  LD  (addri.rp  which  directly  specifies  HL  as  the  source 
register  pair. 
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LD  (addr),IX 


Store  the  contents  of  Index  register  IX  in  memory.  The  third  and  fourth  object  code 
bytes  give  the  address  of  the  memory  location  where  the  low-order  byte  is  to  be  writ- 
ten. The  high-order  byte  is  written  into  the  next  sequential  memory  location. 


LD  (addrlJY 


FD  22  ppqq 


This  instruction  is  identical  to  the  LD  iaddri.lX  instruction,  except  that  it  uses  the  lY 
register  instead  of  the  IX  register. 
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LD  (HL), data  — LOAD  IMMEDIATE  INTO  MEMORY 
LD  (iX+disp),data 
LD  {IY+disp),data 

S    Z  Ac  P/O  N  C 

TTTTTn 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
iY 


mmmm 

ppqq 

ppqq  +  d 


The  illustration  shows  execution  of  LD  (IX+d),xx: 

LDJIX+displ.data 

DD  36    d  XX 

Load  Immediate  into  the  Memory  location  designated  by  base  relative  addressing. 
Suppose  ppqq=5400ig.  After  the  instruction 

LD  (IX+9),FAH 
has  executed,  memory  location  5409-|g  will  contain  FAig. 

LDJIY+disp),data 

FD  36     d  XX 

This  instruction  is  identical  to  LD  (IX+disp),data,  but  uses  the  IY  register  instead  of  the 
IX  register. 

LDJHU.data 
36  XX 

Load  Immediate  into  the  Memory  location  (specified  by  the  contents  of  the  HL  register 
pair). 

The  Load  Immediate  into  Memory  instructions  are  used  much  less  than  the  Load  Im- 
mediate into  Register  instructions. 


3-107 


LD  (HD.reg  — LOAD  MEMORY  FROM  REGISTER 

LD  (IX+disp),reg 
LD  (IY+disp),reg 


S   Z  Ac  P/O  N  C 


A 
B,C 
D.E 
H.L 
SP 
PC 
IX 
lY 


1 

pp 

qp 

mmmm 

The  illustration  shows  execution  of  LD  (HU.reg: 

LD  (HU.reg 


01 110 XXX 


000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Load  memory  location  (specified  by  the  contents  of  the  HL  register  pair)  from  specified 
register. 

Suppose  ppqq=4500ig  and  Register  C  contains  F9ig.  After  the  instruction 

LD  (HU.C 

has  executed,  memory  location  4500-|g  will  contain  F9ig. 

LD  (IX+disp),reg 


^ — X 

DDOmOxxxd 


 ^same  as  for  LD  (HD.reg 

Load  memory  location  (specified  by  the  sum  of  the  contents  of  the  IX  register  and  the 
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displacement  value  d)  from  specified  register. 

LD  (IY+disp),reg 


FDOIIIOxxxb 


 ^same  as  for  LD  (HU.reg 

This  instruction  is  identical  to  LD  (IX+displ.reg,  except  that  it  uses  the  lY  register  in- 
stead of  the  IX  register. 

LD  {rp>,A  —  LOAD  ACCUMULATOR  INTO  THE  MEMORY 
LOCATION  ADDRESSED  BY  REGISTER  PAIR 


S  Z  AqP'O  N  c 


c 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


1 


BC  or  DE 

contain  ppqq 

L 


Data 
Memory 


Program 
Memory 


000x0010 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


LD  !rp),A 


0  if  register  pair=BC 

1  if  register  pair=DE 

Store  the  Accumulator  in  the  memory  bvte  addressed  by  the  BC  or  DE  register  pair. 

Suppose  the  BC  register  pair  contains  084Aig  and  the  Accumulator  contains  3Aig. 
After  the  instruction 

LD  (BCLA 

has  executed,  memory  byte  084Ai6  will  contain  3Ai6- 

The  LD  (rpl.A  and  LD  rp.data  will  normally  be  used  together,  since  the  LD  rp,data  in- 
struction loads  a  16-bit  address  into  the  BC  or  DE  registers  as  follows: 

LD  BC,084AH 
LD  !BC),A 
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LDD— TRANSFER  DATA  BETWEEN  MEMORY  LOCATIONS, 

DECREMENT  DESTINATION  AND  SOURCE  ADDRESSES 


Set  if  BC- 1  5*  0,  reset  otherwise 


mmmm  -t  2 
mmmm  +  3 


LDD 
ED  A8 

Transfer  a  byte  of  data  from  memorY  location  addressed  by  the  HL  register  pair  to 
memory  location  addressed  by  the  DE  register  pair.  Decrement  contents  of  register 
pairs  BC..  DE,  and  HL. 

Suppose  register  pair  BC  contains  004Fi6,  DE  contains  4545i6.  HL  contains  201 2ie, 
and  memory  location  201 2ig  contains  18ig.  After  the  instruction 

LDD 

has  executed,  memory  location  4545i g  will  contain  1  S-j register  pair  BC  will  contain 
004Eig,  DE  will  contain  4544i6.  and  HL  will  contain  201 1  ig. 
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LDDR  — TRANSFER  DATA  BETWEEN  MEMORY 
LOCATIONS  UNTIL  BYTE  COUNTER  IS 
ZERO.  DECREMENT  DESTINATION  AND 
SOURCE  ADDRESSES 

LDDR 

ED  B8 

This  instruction  is  identical  to  LDD.  except  that  it  is  repeated  until  the  BC  register  pair 
contains  zero.  After  each  data  transfer,  interrupts  will  be  recognized  and  two  refresh  cy- 
cles will  be  executed. 

Suppose  we  have  the  following  contents  in  mennorv  and  register  pairs: 
Register/Contents  Location/Contents 
HL    201216  201216  18i6 

DE  454516  2011i6AAi6 
BC    000316  201016  25i6 

After  execution  of 

LDDR 

register  pairs  and  memory  locations  will  have  the  following  contents: 

Register/Contents        Location/Contents  Location/Contents 

HL    200916  201216    18i6  4545i6  18i6 

DE    4542i6  201 1i6    AAi6  4544i6  AAi6 

BC    OOOO16  2OIO16    25i6  454316  25i6 

This  instruction  is  extremely  useful  for  transferring  blocks  of  data  from  one  area  of 
memory  to  another. 
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LDI 


—  TRANSFER  DATA  BETWEEN  MEMORY 

LOCATIONS.  INCREMENT  DESTINATION  AND 
SOURCE  ADDRESSES 


Set  if  BC- 1  1^  0,  reset  otherwise 


mmmm  +  2 
mmmm  +  3 


ED  AO 

Transfer  a  byte  of  data  from  memorv  location  addressed  by  the  HL  register  pair  to 
memory  location  addressed  by  the  DE  register  pair.  Increment  contents  of  register  pairs 
HL  and  DE.  Decrement  contents  of  the  BC  register  pair. 

Suppose  register  pair  BC  contains  004F-|g,  DE  contains  4545-|g,  HL  contains  2012-|g, 
and  memory  location  201 2i6  contains  ISig.  After  the  instruction 

LDI 

has  executed,  memory  location  4545ig  will  contain  18ig,  register  pair  BC  will  contain 
004Ei6.      will  contain  4546i6.  and  HL  will  contain  201 3ig. 
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LDIR  — TRANSFER  DATA  BETWEEN  MEMORY 
LOCATIONS  UNTIL  BYTE  COUNTER  IS 
ZERO. INCREMENT  DESTINATION  AND 
SOURCE  ADDRESSES 


This  instruction  is  identical  to  LDI.  except  that  it  is  repeated  until  the  BC  register  pair 
contains  zero.  After  each  data  transfer,  interrupts  will  be  recognized  and  two  refresh  cy- 
cles will  be  executed. 

Suppose  we  have  the  following  contents  in  memory  and  register  pairs: 


Register/Contents 
HL  2012i6 
DE  454516 
BC  000316 


Location/Contents 

201216  1816 
201316  CDi6 
201416  F0i6 


-After  execution  of 


LDIR 


register  pairs  and  memory  will  have  the  following  contents: 

Register/Contents        Location/Contents  Location/Contents 

HL    201516  201216    18i6  4545i6  18i6 

DE    4548i6  201 3i 6    CDie  4546i6  CDi6 

BC    OOOOie  201416    F0l6  4547i6  F0i6 

This  instruction  is  extremely  useful  for  transferring  blocks  of  data  from  one  area  of 
memory  to  another. 

NEG  —  NEGATE  CONTENTS  OF  ACCUMULATOR 


S    Z  Ac  P/O  N  C 


Data 
Memory 


Program 
Memorv 


.ED 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


Negate  contents  of  Accumulator.  This  is  the  same  as  subtracting  contents  of  the  Ac- 
cumulator from  zero.  The  result  is  the  two's  complement.  80H  will  be  left  unchanged. 

Suppose  xx=5Ai6.  After  the  instruction 

NEG 

has  executed,  the  Accumulator  will  contain  A6i6. 

5A  =  0  1  0  1      10  10 
Two's  complement  =  10  10     0  110 
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NOP  —  NO  OPERATION 

S    Z  AqP/O  N  c 


A 

B.cl 
D  e| 

h.lI 
spI 

PC  I 
IX  I 
iyI 


Data 
Memory 


Program 
Memory 


00 


mmmm  + 1 
mmmm  +  2 
mmmm  3 


This  IS  a  one-byte  instruction  which  perfornns  no  operation,  except  that  the  Program 
Counter  is  incremented  and  memory  refresh  continues.  This  instruction  is  present  for 
several  reasons: 

1)  A  program  error  that  fetches  an  object  code  from  non-existent  memory  will  fetch 
00.  It  is  a  good  idea  to  ensure  that  the  most  common  program  error  will  do  nothing. 

2)  The  NOP  instruction  allows  you  to  give  a  label  to  an  object  program  byte: 
HERE  NOP 

3)  To  fine-tune  delay  times.  Each  NOP  instruction  adds  four  clock  cycles  to  a  delay. 


NOP  is  not  a  very  useful  or  frequently  used  instruction. 
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OR  data  — OR  IMMEDIATE  WITH  ACCUMULATOR 


S  Z  Ac  P/O  N  C 
F|X|X|1  IXIOIOI 


OR  data 
F6  w 

OR  the  Accumulator  with  the  contents  of  the  second  instruction  object  code  byte. 
Suppose  xx=3Ai6-  *fter  the  instruction 

OR  7CH 

has  executed,  the  Accumulator  will  contain  7E-16- 
3A  =  0  0  1  1      10  10 


7C 


0  111  1100 


0  sets  S  to  0. 


0  111 


1110 

1 1 


-Six  1  bits,  set  P/O  to  1 


'  Non-zero  result,  set  Z  to  0 


This  is  a  routine  logical  instruction;  it  is  often  used  to  turn  bits  "on"  For  example,  the 
instruction 

OR  80H 

will  unconditionally  set  the  high-order  Accumulator  bit  to  1. 
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OR  reg  —  OR  REGISTER  WITH  ACCUMULATOR 

S    Z  Ac  P/O  N  C 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 


Ixlxh  Ixlolo 

XX 

mmmm 

Contents  of  A.  B. 
,  D,  E.  H  or  L 
is  VY 


Data 
Memory 


Program 
Memory 


10110XXX 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


reg 

XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Logically  OR  the  contents  of  the  Accumulator  with  the  contents  of  Register  A,  B,  C.  D, 
E,  H  or  L  Store  the  result  in  the  Accumulator. 

Suppose  xx=E3ig  and  Register  E  contains  A8ig.  After  the  instruction 

OR  E 

has  executed,  the  Accumulator  will  contain  EB-jg. 

E3  =  1  1  1  0     0  0  1  1 


A8 


10  10  1000 


1110 


1  sets  S  to 


1-aS  1 


10  11 

A 


Six  1  bits,  set  P/O  to  1 
' — Non-zero  result,  set  Z  to  0 
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OR  (HU  —  OR  MEMORY  WITH  ACCUMULATOR 
OR  (IX+disp) 
OR  (lY+disp) 

S   Z  Ac  P/O  N  C 
F|X|X|  1|X|o3o] 


A 
B,C 
D.E 
H.L 
SP 
PC 
IX 
lY 


XX 

PP 

qq 

mmmm 

XX  OR  yy 


The  illustration  shows  execution  of  OR  (HU: 

OR  (HL) 


Data 
Memory 


ppqq 


Program 
Memory 


B5 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


OR  contents  of  memory  location  (specified  bv  the  contents  of  the  HL  register  pair)  with 
the  Accumulator. 

Suppose  xx=E3i6.  ppqq=4000-|g,  and  memon/  location  4000ig  contains  A8ig.  After 
the  instruction 

OR  (HL) 

has  executed,  the  Accumulator  will  contain  EBig- 

E3  =  1  1  1  0  0  0  1  1 
A8  =  1  0  1  0     10  0  0 


1  sets  S  to  1 


1110     10  11 

I 


-Six  1  bits,  set  P/O  to  1 


— Non-zero  result,  set  Z  to  0 

ORjX+disp) 
DD  B6  d 

OR  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the  IX  register 
and  the  displacement  value  d)  with  the  Accumulator. 

ORjIY+disp) 
FD  B6  d 

This  instruction  is  identical  to  OR  (IX+disp),  except  that  it  uses  the  lY  register  instead  of 
the  IX  register. 
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OUT  (C),reg  — OUTPUT  FROM  REGISTER 


S    Z  Ac  P/O  N  C 


A 
B.C 
O.E 
H,L 
SP 
PC 
IX 
lY 


-1. 


VY 

mmmm 

HI  I/O  port  yy  I 

Register  A,  B,  C, 
'  D,  E,  H  or  L 


OUT  (O.reg 


Data 
Memory 


Program 
Memory 


ED 


OlxxxOOl 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


ED  01  XXX  001 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Suppose  yy=1FiQ  and  the  contents  of  H  are  AAig.  After  the  execution  of 

OUT  (C),H 

AAig  will  be  in  the  buffer  of  I/O  port  IFig- 
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OUTD  — OUTPUT  FROM  MEMORY.  DECREMENT  ADDRESS 


S    Z  Ac  P/O  N  C 


T 

•j  I/O  port  yy  | 

Data 
Memory 

f 

^  Ppqq-1  ) 

Program 
Memory 


ED 


AB 


ppqq 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


Output  from  memory  location  specified  by  HL  to  I/O  port  addressed  by  Register  C. 
Registers  B  and  HL  are  decremented. 

Suppose  xx=OA-ig,  vy=FF-]6.  ppqq=5000ig,  and  memory  location  BOOOig  contains 
77i5.  After  the  instruction 

OUTD 

has  executed.  77ig  will  be  held  in  the  buffer  of  I/O  port  FFig.  The  B  register  will  con- 
tain 09-]  g,  and  the  HL  register  pair4FFFig. 

OTDR  — OUTPUT  FROM  MEMORY.  DECREMENT  ADDRESS, 
CONTINUE  UNTIL  REGISTER  B=0 

OTDR 

ED  BB 

OTDR  is  identical  to  OUTD.  but  is  repeated  until  Register  B  contains  0. 

Suppose  Register  B  contains  03ig,  Register  C  contains  FF-|g,  and  HL  contains  5000ig. 
Memory  locations  4FFEig  through  5000ig  contain: 

Location/Contents 

4FFE16  CAig 
4FFFig  IBig 
50001 g  F1i6 


After  execution  of 


OTDR 


register  pair  HL  will  contain  4FFDig.  Register  B  will  contain  zero,  and  the  sequence 
F1  ig.  IBig,  CAig  will  have  been  written  to  I/O  port  FFig. 

This  instruction  is  very  useful  for  transferring  blocks  of  data  from  memory  to  output 
devices. 
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OUTI  —  OUTPUT  FROM  MEMORY.  INCREMENT  ADDRESS 


S    Z  Ac  P/O  N  C 


A 
B.C 
D.E 
H,L 
SP 
PC 
IX 
lY 


PP 


»|  I/O  port  yy  \ 

Data 
Memory 

ppqq 


Program 
Memorv 


ED 


A3 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


OUTI 
ED  A3 

Output  from  memorv  location  specified  bv  HL  to  I/O  port  addressed  by  Register  C. 
Register  B  is  decremented  and  the  HL  register  pair  is  incremented. 

Suppose  xx=OAig,  vy=FFi6,  ppqq=5000i5,  and  memorv  location  5000ig  contains 
77ig.  After  the  instruction 

OUTI 

has  executed,  77-|g  will  be  held  in  the  buffer  of  I/O  port  FFig.  The  B  register  will  con- 
tain 09-|g  and  the  HL  register  pair  will  contain  5001  ig. 

OTIR  — OUTPUT  FROM  MEMORY.  INCREMENT  ADDRESS, 
CONTINUE  UNTIL  REGISTER  B=0 

OTIR 

ED  B3 

OTIR  is  identical  to  OUTI,  except  that  it  is  repeated  until  Register  B  contains  0. 

Suppose  Register  B  contains  04ig,  Register  C  contains  FFig,  snd  HL  contains  5000ig. 
Memorv  locations  5000ig  through  5003ig  contain: 

Location/Contents 
BOOOig  CAig 
5001ig  IBig 
5002ig  BI16 
5003ig  ADig 


After  execution  of 


OTIR 


register  pair  HL  will  contain  5004-|g,  Register  B  will  contain  zero  and  the  sequence 
CAig,  IBig,  Blig  and  ADig  will  have  been  written  to  I/O  port  FFig. 

This  instruction  is  very  useful  for  transferring  blocks  of  data  from  memory  to  an  output 
device. 
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OUT  (port),A  — OUTPUT  FROM  ACCUMULATOR 

S    Z  Ac  P/O  N  C 


A 
B.C 
0,E 
H.L 
SP 
PC 
IX 
lY 


!/0  port  yv 


Data 
Memory 


Program 
Memory 


D3 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


OUT  (port).A 


U6  vy 

Output  the  contents  of  the  Accumulator  to  the  I/O  port  identified  by  the  second  OUT  in- 
struction object  code  byte. 

Suppose  36-] 6  is  held  in  the  Accumulator.  After  the  instruction 

OUT  (lAHl.A 

has  executed,  36ig  will  be  in  the  buffer  of  I/O  port  lAig. 

The  OUT  instruction  does  not  affect  any  statuses.  Use  of  the  OUT  instruction  is  very 
hardware-dependent.  Valid  I/O  port  addresses  are  determined  by  the  way  in  which  I/O 
logic  has  been  implemented.  It  is  also  possible  to  design  a  microcomputer  system  that 
accesses  external  logic  using  memory  reference  instructions  with  specific  memory  ad- 
dresses. OUT  instructions  are  frequently  used  in  special  ways  to  control  microcomputer 
logic  external  to  the  CPU. 
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POP  rp  —  READ  FROM  THE  TOP  OF  THE  STACK 
POP  IX 
POP  lY 

S   Z  AqP/O  n  c 


Data 
Memory 

qq      I  ssss 
pp      I ssss  + 
ssss  +  2 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  POP  BC. 

POPjp_ 

/  /V 
11  XX  0001 

00  for  rp  is  register  pair  BC 

01  for  rp  IS  register  pair  DE 

10  for  rp  is  register  pair  HL 

1 1  for  rp  is  register  pair  A  and  F 

POP  the  two  top  stack  bytes  into  the  designated  register  pair. 
Suppose  qq=01-|6  and  pp=2A-ig.  Execution  of 

POP  HL 

loads  01 15  into  the  L  register  and  2Ai  g  into  the  H  register.  Execution  of  the  instruction 

POP  AF 

loads  01  into  the  status  flags  and  2Ai6  into  the  Accumulator.  Thus,  the  Carry  status 
will  be  set  to  1  and  other  statuses  will  be  cleared. 

POP  IX 
DD  El 

POP  the  two  top  stack  bytes  into  the  IX  register. 

POP  lY 
FD  El 

POP  the  two  top  stack  bytes  into  the  lY  register. 

The  POP  instruction  is  most  frequently  used  to  restore  register  and  status  contents 
which  have  been  saved  on  the  stack;  for  example,  while  servicing  an  interrupt. 
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PUSH  rp  — WRITE  TO  THE  TOP  OF  THE  STACK 
PUSH  IX 
PUSH  lY 


S    Z  Ac  P/O  N  C 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


ssss 

mmmm 

ppqq 

illustration  shows 



execution  of  PUSH 

Data 
Memory 


qq 


ssss-2 
ssss-1 
ssss 


Program 
Memory 


FD 


E5 


PUSH  lY 
FD  E5 

PUSH  the  contents  of  the  lY  register  onto  the  top  of  the  stack. 
Suppose  the  lY  register  contains  45FF-|6-  Execution  of  the  instruction 

PUSH  lY 

loads  45-) g,  then  FF-|g  onto  the  top  of  the  stack. 

PUSH  IX 
DD  E5 

PUSH  the  contents  of  the  IX  register  onto  the  top  of  the  stack. 

PUSH  rp 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


11    XX  0101 


00  for  rp  is  register  pair  BC 

01  for  rp  IS  register  pair  DE 

10  for  rp  is  register  pair  HL 

1 1  for  rp  IS  register  pair  .A  and  F 

PUSH  contents  of  designated  register  pair  onto  the  top  of  the  stack. 
Execution  of  the  instruction 

PUSH  AF 

loads  the  Accumulator  and  then  the  status  flags  onto  the  top  of  the  stack. 

The  PUSH  instruction  is  most  frequently  used  to  save  register  and  status  contents;  for 
example,  before  servicing  an  interrupt. 
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RES  b,reg  —  RESET  INDICATED  REGISTER  BIT 

S   Z  AcP/O  N  C 


A 
B.C 
O.E 
H.L 
SP 
PC 
IX 
lY 


yyyyyyyy 

—4  

mmmm 

CD 


RES  b.reg 


10  bbb  XXX 

Bit  bbb  XXX  Register 

0  000  000  B 

1  001  001 

2  010  010 

3  Oil  Oil 

4  100  100 

5  101  101 

6  110  111 

7  111 


Data 
Memory 


Program 
Memory 


CB 


lObbbxxx 


mmnim 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


Reset  indicated  bit  within  specified  register. 
After  tlie  instruction 

RES  6.H 

has  executed,  bit  6  in  Register  H  will  be  reset.  (Bit  0  is  the  least  significant  bit.) 
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RES  b,(HU  —  RESET  BIT  b  OF  INDICATED  MEMORY  POSITION 
RES  b,(IX+disp) 
RES  b,(IY+disp> 


S  Z  Ac  P/O  N  C 
FdXI 


n 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 


mmmm 

> 

ppqq 



Data 
Memorv 

VyyVYYW 

ppqq  +  d 


mmmm  +  4 


ppqq  +  d 


Program 
Memorv 


DD 


CB 


lObbbl 10 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 

mmmm  +  4 


The  illustration  shows  execution  of  SET  b.ilX+disp).  Bit  0  is  execution  of  SET 
b,(IX+disp).  Bit  0  IS  the  least  significant  bit 

RES  b,(IX+disp) 


DDCB  d  10  bbb  110 


bbb 

Bit  Reset 

000 

0 

001 

1 

010 

2 

Oil 

3 

100 

4 

101 

5 

110 

6 

111 

7 

Reset  indicated  bit  within  memorv  location  indicated  by  the  sum  of  Index  Register  IX 
and  d. 

Suppose  IX  contains  41 10-|g.  After  the  instruction 

RES  0,(IX+7I 

has  executed,  bit  0  in  memorv  location  4n7-ig  will  be  0. 

RES  b,(IY+disp) 


FDCB  d  10  bbb  110 

bbb  IS  the  same  as  in  RES  b,(IX+disp) 
This  instruction  is  identical  to  RES  b,(IX+disp),  except  that  it  uses  the  lY  register  instead 
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of  the  IX  register. 


RES  b.(HL) 

l\x 

CB  lObbb  110 


bbb  IS  the  same  as  in  RES  b,(IX+displ 
Reset  indicated  bit  within  memory  location  indicated  by  HL. 
Suppose  HL  contains  4444-)  g.  After  execution  of 

RES  7.(HL) 

bit  7  in  memory  location  4444ig  will  be  0. 
RET  — RETURN  FROM  SUBROUTINE 

S   Z  Ac  P/O  N  C 
i    I    I     I    I     I  I 


Data 
Memorv 


PP 


Program 
Memorv 


C9 


xxxx 
xxxx  +  1 
xxxx  +  2 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


RET 
C9 

Move  the  contents  of  the  top  two  stack  bytes  to  the  Program  Counter;  these  two  bytes 
provide  the  address  of  the  next  instruction  to  be  executed.  Previous  Program  Counter 
contents  are  lost.  Increment  the  Stack  Pointer  by  2,  to  address  the  new  top  of  stack. 

Every  subroutine  must  contain  at  least  one  Return  (or  conditional  Return)  instruction; 
this  IS  the  last  instruction  executed  within  the  subroutine,  and  causes  execution  to 
return  to  the  calling  program. 
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RET  cond  — RETURN  FROM  SUBROUTINE  IF  CONDITION 
IS  SATISFIED 


RET  cond 


11  XXX  000 


Condition 

Relevant  Flag 

000 

NZ 

Non-Zero 

Z 

001 

z 

Zero 

z 

010 

NC 

Non-Carry 

c 

oil 

C 

Carry 

c 

100 

PO 

Parity  Odd 

P/0 

101 

PE 

Parity  Even 

P/0 

110 

P 

Sign  Positive 

s 

111 

M 

Sign  Negative 

s 

This  instruction  is  identical  to  the  RET  instruction,  except  that  the  return  is  not  ex- 
ecuted unless  the  condition  is  satisfied;  othervs/ise,  the  instruction  sequentially  follow- 
ing the  RET  cond  instruction  will  be  executed. 

Consider  the  instruction  sequence: 

 ; 


CALL 
AND 


SUBR 
7CH-^ 


slIsr- 


R!T 


0  i 


:First  subroutine  instruction 

condition  satisfied 


cond  I 


condition  not 
satisfied 


80H 


After  the  RET  cond  is  executed,  if  the  condition  is  satisfied  then  execution  returns  to  the 
AND  instruction  which  follows  the  CALL.  If  the  condition  is  not  satisfied,  the  OR  in- 
struction, being  the  next  sequential  instruction,  is  executed. 
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RETI  —  RETURN  FROM  INTERRUPT 

I  c 

n 


S   Z  AcP/0  N  C 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


XXXX 

mmmm 

Move  the  contents  of  the  top  two  stack  bytes  to  the  Program  Counter:  these  two  bytes 
provide  the  address  of  the  next  instruction  to  be  executed.  Previous  Program  Counter 
contents  are  lost.  Increment  the  Stack  Pointer  by  2,  and  address  the  new  top  of  stack. 

This  instruction  is  used  at  the  end  of  an  interrupt  service  routine,  and.  In  addition  to 
returning  control  to  the  interrupted  program,  it  is  used  to  signal  an  I/O  device  that  the 
interrupt  routine  has  been  completed.  The  I/O  device  must  provide  the  logic  necessary 
to  sense  the  instruction  operation  code:  refer  to  An  Introduction  to  Microcom- 
puters: Volume  2  for  a  description  of  how  the  RETI  instruction  operates  with  the  Z80 
family  of  devices. 
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RETN  —  RETURN  FROM  NON-MASKABLE  INTERRUPT 


RETN 
ED^ 

Move  the  contents  of  the  top  two  stack  bytes  to  the  Program  Counter:  these  two  bvtes 
provide  the  address  of  the  next  instruction  to  be  executed.  Previous  Program  Counter 
contents  are  lost.  Increment  the  Stack  Pointer  bv  2  to  address  the  new  top  of  stack. 
Restore  the  interrupt  enable  logic  to  the  state  it  had  prior  to  the  occurrence  of  the  non- 
maskable interrupt. 

This  instruction  is  used  at  the  end  of  a  service  routine  for  a  non-maskable  interrupt,  and 
causes  execution  to  return  to  the  program  that  was  interrupted. 
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RL  reg  —  ROTATE  CONTENTS  OF  REGISTER  LEFT 
THROUGH  CARRY 


Z  Ac  P/0  N  \ 


D.E 
H.L 
SP 
PC 
IX 
lY 


} 


The  illustration  shows  execution  of  RL  C. 

RL  reg 

CB  00010  XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

01 1  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Rotate  contents  of  specified  register  left  one  bit  through  Carry. 
Suppose  D  contains  A9ig  and  CarrY=0.  After  the  instruction 

RL  D 

has  executed.  D  will  contain  52i6  and  Carry  will  be  1 

Before  After 
Register  D  Carry 

110  10  1  ooTl  \q\ 


0  sets  S  to  0-«— ' 
3  ones,  set  P/0  to  0 


Data 
Memory 


Program 
Memory  | 


CB 


0CX)10001 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


Non-zero  result  set  Z  to  0 
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RL  (HL)  —     ROTATE  CONTENTS  OF  MEMORY  LOCATION 
RL  (IX+disp/  LEFT  THROUGH  CARRY 
RL  (lY+disp) 


S    Z  AqP'O  N  ({ 
X  I  X  1  0  I  X  I  0  ["tl 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 


mmmm  | 

ppqq 



-J  ppqq  +  c 


'ppqq  +  d 

4 


mmmm  +  4 


Program 
Memory 

DD 

mnrimm 

CB 

mmmm  + 1 

d 

mmmm  +  2 

16 

mmmm  +  3 

mmmm  +  4 

The  illustration  shows  execution  of  RL  (IX+disp): 

RL  !lX+disp) 


DD  CB 


16 


Rotate  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  Index 
Register  IX  and  displacement  integer  d)  left  one  bit  through  Carry. 

Suppose  the  IX  register  contains  4000ig,  memory  location  4007i5  contains  2Fi6.  and 
Carry  is  set  to  1.  After  execution  of  the  instruction 

RL  (IX+7) 

memory  location  4007ig  will  contain  5F-]g,  and  Carry  is  0: 
Before  After 
Carry 


Memory 


00101111 


□ 


0  sets  S  to  0-^ — ' 
6  ones,  set  P/0  to  1 

RL  (lY+disp) 


Non-zero  result,  set  Z  to  0 


FD  CB  d  16 


This  instruction  is  identical  to  RL  (IX+disp),  but  uses  the  lY  register  instead  of  the  IX 
register. 
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RL  !HL) 


CB  16 

Rotate  contents  of  memory  location  (specified  by  tlie  contents  of  the  HL  register  pair) 
left  one  bit  through  Carry. 

RLA  —  ROTATE  ACCUMULATOR  LEFT  THROUGH  CARRY 


_  17.  mmmm 

_    mmmm  +  1 

  mmmm  +  2 

  mmmm  +  3 

RLA 


Rotate  Accumulator  contents  left  one  bit  through  Carry  status. 

Suppose  the  Accumulator  contains  2A-]g  and  the  Carry  status  is  set  to  1.  After  the  in- 
struction 

RLA 

has  executed,  the  Accumulator  will  contain  F5-]  g  and  the  Carry  status  will  be  reset  toO: 
Before  After 
Accumulator      Carry         Accumulator  Carry 

10  1  1  1  1  0  i"o1     03       1 1  1  1  1  0  1  oTl  (o] 
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RLC  reg  — ROTATE  CONTENTS  OF  REGISTER  LEFT  CIRCULAR 


I  S    Z  Ac  P/O  N    C  I 

1    Hxixlolxlol  W 


A 

B.C 

H.L 
SP 
PC 
IX 
lY 


The  illustration  shows  execution  of  RLC  E: 

RLC  reg 


Data 
Memory 


Program 
Memory 


CB 


00000011 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


CBOOO  00  XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

01 1  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Rotate  contents  of  specified  register  left  one  bit,  copving  bit  7  into  Carry. 
Suppose  Register  D  contains  AS-je  and  Carry  is  1.  After  execution  of 

RLC  D 

Register  D  will  contain  53-] g  and  Carry  will  be  1 : 

Before  After 
Register  D        Carry  Register  D  Carry 

|1  0  1  0  1  0  0~n      U]       10  10  1  00  1  11  Q] 


0  sets  S  to  0- 
4  ones,  set  P/O  to  1 


Non-zero  result,  set  Z  to  0 
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RLC  (HL)  —      ROTATE  CONTENTS  OF  MEMORY  LOCATION 
RLC  (IX+disp)  LEFT  CIRCULAR 
RLC  (lY+dIsp) 


S    Z  Ac  P/O  N  C 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 


PP 

qq 

mmmm 

Data 
Memorv 

-Jppqq 


Program 
Memorv 


CB 


mmmrti 
mmmm  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  RLC  (HL): 

RLC  (HU 
CB  06 

Rotate  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register  pair) 
left  one  bit.  copying  bit  7  into  Carry. 

Suppose  register  pair  HL  contains  54FF-|g.  Memory  location  54FFi6  contains  A5-ig. 
and  Carry  is  0.  After  execution  of 

RLC  (HL) 

memory  location  54FF-|g  will  contain  4Bi6.       Carry  will  be  1; 

Before  After 
Memory         Carry  Memory 


Carry 


|i  0 1  0  0 1  oT|    [o]      |o  1  00  1  0  i"T|  |T] 


0  sets  S  to  0 
4  ones,  set  P/O  to  1 


Non-zero  result,  set  Z  lo  0 


RLC  (IX+disp) 


DD  CB  a  06 

Rotate  memory  location  (specified  by  the  sum  of  the  contents  of  Index  register  IX  and 
displacement  integer  d)  left  one  bit,  copying  bit  7  into  Carry. 

Suppose  the  IX  register  contains  4000i  g.  Carry  is  1.  and  memory  location  4007ig  con- 
tains 2F-|g.  After  the  instruction 

RLC  (IX+7) 
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has  executed,  memory  location  4007ig  will  contain  5E-|g,  and  Carry  will  be  0: 
Before  After 
Memory         Carry  Memory  Carry 

100  1  0  1  11  1|     [T)       |0  1  0  1  1  1  i"o]  [o] 


0  sets  S  to  0  ■ 
5  ones,  set  P/0  to  0 


Non-zero  result,  set  Z  to  0 


RLC  (lY+disp) 


FD  CB  a  06 


This  instruction  is  identical  to  RLC  (IX+disp),  but  uses  the  lY  register  instead  of  the  IX 
register. 

RLCA  —  ROTATE  ACCUMULATOR  LEFT  CIRCULAR 




S    Z  Aq  P/O  N  C 

FCTEEm 


Data 
Memory 


Program 
Memory 


07 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  -f  3 


RLCA 
07 

Rotate  Accumulator  contents  left  one  bit.  copying  bit  7  into  Carry. 

Suppose  the  Accumulator  contains  7Aig  and  the  Carry  status  is  set  to  1.  After  the  in- 
struction 

RLCA 

has  executed,  the  Accumulator  will  contain  F4-]g  and  the  Carry  status  will  be  reset  to  0: 
Before  After 
Accumulator      Carry         Accumulator  Carry 

[0111  10101    0]      i  1  1  1  1  0 1  o"ol  jo] 

RLCA  should  be  used  as  a  logical  instruction. 
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RLD  —  ROTATE  ONE  BCD  DIGIT  LEFT  BETWEEN 

THE  ACCUMULATOR  AND  MEMORY  LOCATION 


A 
B.C 
O.E 
H.L 
SP 
PC 
IX 
lY 


S   Z  AcP'O  N  C 


FlXlXlO 


Em: 


X      1  V 

pp 

qq 

mmmm 

Data 
Memorv 


ppqq 


5J 


Program 
Memory 


ED 


6F 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


The  four  low-order  bits  of  a  memory  location  (specified  by  the  contents  of  register  pair 
HU  are  copied  into  the  four  high-order  bits  of  the  same  memory  location.  The  previous 
contents  of  the  four  high-order  bits  of  that  memory  location  are  copied  into  the  four 
low-order  bits  of  the  Accumulator.  The  previous  four  low-order  bits  of  the  Accumulator 
are  copied  into  the  four  low-order  bits  of  the  specified  memory  location. 

Suppose  the  Accumulator  contains  '7f]Q.  HL  register  pair  contains  4000ig,  and  memo- 
ry location  4000i6  contains  12i6-  After  execution  of  the  instruction 

RLD 

the  Accumulator  will  contain  71  ig  and  memory  location  4000ig  will  contain  2Fig: 


Before 

Accumulator  Memory 


7 


T~i  mm 


high-order  bit=0,  set  S  to  0 
4  ones,  set  P/0  to  1 


After 

Accumulator  Memory 

7  I  1  I  frm 


"Non-zero  result,  set  Z  to  0 
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RR  reg  —  ROTATE  CONTENTS  OF  REGISTER  RIGHT  THROUGH 
CARRY 


S    Z  Aq  P/O  N  c 
P(X|X|0[X[0|3>- 


} 


The  illustration  shows  execution  of  RR  C: 


Data 
Memory 


Program 
Memory 


CB 


00011001 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


RR  reg 

CB  00011  XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

01 1  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Rotate  contents  of  specified  register  right  one  bit  through  Carrv. 
Suppose  Register  H  contains  OF-jg  and  Carry  is  set  to  1.  After  the  instruction 

RR  H 

has  executed.  Register  H  will  contain  87ig,  and  Carry  will  be  1 
Before  After 
Carrv 


Register  H 


Register  H 


loooo  1 1  iT]    U]     1 1  0 0 0  0  1  i~n 


1  sets  S  to  1 
4  ones,  set  P/0  to  1 


Carry 

m 


Non-zero  result,  set  Z  to  0 
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RR  (HL)  —  ROTATE  CONTENTS  OF  MEMORY  LOCATION 

RIGHT  THROUGH  CARRY 
RR  (IX+dIsp) 
RR  (lY+dIsp) 


s  z     p'o  N  d 


A 
B,C 
D,E 
H.L 
SP 
PC 
IX 
lY 


mmmm 

PP 

qq 

Data 
Memory 


ppqq  +  d 

i, 


Program 
Memory 

FD 

mmmnn 

CB 

mmmm  + 1 

mmmm  +  2 

mmmm  +  3 

mmmm  +  4 

The  illustration  shows  execution  of  RR  (lY+disp); 

RR  (IY+diS£) 


FD  CB  a  IE 

Rotate  contents  of  memory  location  (specified  bv  the  sum  of  the  contents  of  the  lY 
register  and  the  displacement  value  d)  right  one  bit  through  Carry. 

Suppose  the  lY  register  contains  4500i  q,  memory  location  450Fi  g  contains  1  Di  g.  and 
Carry  is  set  to  0.  After  execution  of  the  instruction 

RR  (lY+OFHl 

memory  location  450F-|g  will  contain  OEig,  and  Carry  will  be  1 , 
Before  After 
Memory  Carry 

loool  1 1  oil  [o] 


0  sets  S  to  0 
3  ones,  set  P/0  to  0 


Non-zero  result,  set  Z  to  0 


RRjIX+disp) 
DD  CB  a  IE 


This  instruction  is  identical  to  RR  (lY+dispi,  but  uses  the  IX  register  instead  of  the  lY 
register. 
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RR  (HL) 
C8  IE 

Rotate  contents  of  nnennorv  location  (specified  by  the  contents  of  the  HL  register  pair) 
right  one  bit  through  Carry. 

RRA  — ROTATE  ACCUMULATOR  RIGHT  THROUGH  CARRY 


S   Z  Ac  P/0 


TTTl 


•t~t^ 


Data 
Memorv 


Program 
Memory 


IF 


mmmm 
mmmm  *  1 
mmmm  +  2 
mmmm  +  3 


RRA 
IF 

Rotate  Accumulator  contents  right  one  bit  through  Carry  status. 

Suppose  the  Accumulator  contains  7Aig  and  the  Carry  status  is  set  to  1,  After  the  in- 
struction 

RRA 

has  executed,  the  Accumulator  will  contain  BDig  and  the  Carry  status  will  be  reset  to 
0: 


Before 
Accumulator 
10  111  1  0  1  01 


Carry 
□ 


After 

.Accumulator  Carry 

  roi 


10  11  110  1 
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RRC  reg  —  ROTATE  CONTENTS  OF  REGISTER  RIGHT  CIRCULAR 


S    Z  Ac  P/O  N  C 
Fjxlxl 0|X  |0|  48- 


B,C 
D.E 

SP 
PC 
IX 
lY 

I 

R 


Data 
Memory 


Program 
Memory 


CB 


00001101 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  RRC  L; 


RRC  reg 
CB  00001  XXX 


000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Rotate  contents  of  specified  register  right  one  bit  ciroularry,  copying  bit  0  into  the  Carry 
status. 

Suppose  Register  D  contains  A9ig  and  Carry  is  0.  After  execution  of 

RRC  D 

Register  D  will  contain  D4-|g,  and  Carry  will  be  1 : 

Before  After 
Register  D        Carn/  Register  D  Carry 

|1  0  1  0  1  ooTI  [o] 


1 1 1 0 1  0 1  o"ol  [T] 


1  sets  S  to  1  - 
4  ones,  set  P/O  to  1 


-Non-zero  result,  set  Z  to  0 
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RRC  (HU  — 
RRC  (IX+disp) 
RRC  (lY+disp) 


ROTATE  CONTENTS  OF  MEMORY  LOCATION 
RIGHT  CIRCULAR 


S  Z  Ac  P/O  N  C 
F|X|X|0|X|On 


A 
B.C 
O.E 
H.L 
SP 
PC 
IX 
lY 
Ij 
R 


PP 

mmmm 



/  

— 4  

Data 
Memory 

•> 

mm 

Program 
Memory 


CB 


OE 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  RRC  (HU: 

RRC  !HL) 

CB  OE 

Rotate  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register  pair) 
right  one  bit  circularly,  copying  bit  0  Into  the  Carry  status. 

Suppose  the  HL  register  pair  contains  4500ig,  memory  location  4500-]6  contains 
34-|g.  and  Carry  is  set  to  1.  After  execution  of 

RRC  (HL) 

memory  location  4500-]g  will  contain  lAig.  and  Carry  will  be  0: 
Before  After 
Memory         Carry  Memory  Carry 

loo  1  1  0  1  0(J1     0]      10001  1  0  1  o|  [o] 


0  sets  S  to  0 
3  ones,  set  P/0  to  0 

RRC  (IX+disp) 


L 


Non-zero  result,  set  Z  to  0 


DD  CB  d  OE 

Rotate  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the  IX 
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register  and  the  displacement  value  d)  right  one  bit  circularly,  copying  bit  0  into  the  Ca- 
rry status. 

RRC  (lY+disp) 


FD  CB   a  OE 

This  instruction  is  identical  to  the  RRC  (IX+disp)  instruction,  but  uses  the  lY  register  in- 
stead of  the  IX  register. 

RRCA  — ROTATE  ACCUMULATOR  RIGHT  CIRCULAR 


S    Z  Ac  P/O  N  C 


B.C 
D.E 
H,L 
SP 
PC 
IX 
lY 


Data 
Memory 


Program 
Memory 


OF 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


RRCA 
OF 

Rotate  Accumulator  contents  right  one  bit  circularly,  copying  bitO  into  the  Carry  status. 

Suppose  the  Accumulator  contains  ^A-jg  and  the  Carry  status  is  set  to  1.  After  the  in- 
struction 

RRCA 

has  executed,  the  Accumulator  will  contain  3D-ig  and  the  Carry  status  will  be  reset  to 
0: 


Before 


After 

Accumulator  Carry 


Accumulator  Carry 
10111  10101     [T]       100  11  1  1  oT]  [o 
RRCA  should  be  used  as  a  logical  instruction. 
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RRD  —  ROTATE  ONE  BCD  DIGIT  RIGHT  BETWEEN  THE 
ACCUMULATOR  AND  MEMORY  LOCATION 


S    Z  Ac  P/O  N  c 

Flxlx|o|xToTl 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


Data 
Memorv 


Program 
Memory 

ED 
67 


ppqq 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


RRD 


ED  67 

The  four  high-order  bits  of  a  memory  location  (specified  bv  the  contents  of  register  pair 
HU  are  copied  into  the  four  low-order  bits  of  the  same  memorv  location.  The  previous 
contents  of  the  four  low-order  bits  are  copied  into  the  four  low-order  bits  of  the  Ac- 
cumulator. The  previous  four  low-order  bits  of  the  Accumulator  are  copied  into  the  four 
high-order  bits  of  the  specified  memorv  location. 

Suppose  the  Accumulator  contains  7Fig,  HL  register  pair  contains  4000ig,  and  memo- 
rv location  4000-|g  contains  ^2■\Q.  After  execution  of  the  instruction 

RRD 

the  Accumulator  will  contain  72ig  and  memory  location  4000i6  will  contain  F1  iq: 


Before 

Accumulator  Memorv 


7 


1  era  [ 


High-order  bit=0,  set  S  to  0  ■ 
4  ones,  set  P./O  to  1 


After 

Accumulator  Memorv 

7  I  2  I Fm 


■  Non-zero  result, 
set  Z  to  0 
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RST  n  —  RESTART 

S   Z  Ac  P/O  N  C 

c 


1  I  I  I  M 


A 
B.C 
D.E 
H,L 
SP 
PC 
iX 
lY 


PPqq 

mmmm 

i  

RST  n 


11  XXX  111 

Call  the  subroutine  ongined  at  the  low  memorv  address  specified  by  n. 
When  the  instruction 

RST  18H 

has  executed,  the  subroutine  origined  at  memorv  location  001 81  g  is  called.  The  pre- 
vious Program  Counter  contents  are  pushed  to  the  top  of  the  stack. 

Usually,  the  RST  instruction  is  used  in  conjunction  with  interrupt  processing,  as  de- 
scribed in  Chapter  12. 


If  vour  application  does  not  use  all  RST  instruction  codes  to  service  SUBROUTINE 
interrupts,  do  not  overlook  the  possibility  of  calling  subroutines       CALL  USING 
using  RST  instructions.  Origin  frequently  used  subroutines  at  ap-  RST 
propriate  RST  addresses,  and  these  subroutines  can  be  called  with  — — ^— 
a  single-byte  RST  instruction  instead  of  a  three-byte  CALL  instruction. 
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SBC  A.data  — SUBTRACT  IMMEDIATE  DATA  FROM 
ACCUMULATOR  WITH  BORROW 


S    Z  Ac  P/O  N  C 
FIX  1X1X1X1  lTxl 


SBC  A,  data 
DE  vv 

Subtract  the  contents  of  the  second  object  code  bvte  and  the  Carry  status  from  the  Ac- 
cumulator. 

Suppose  xx=3Aig  and  Carry=1.  After  the  instruction 

SBC  A.7CH 

has  executed,  the  Accumulator  will  contain  BDi6- 

3A  =  0  0  11      10  10 
Twos  comp  of7C  =  1000  0100 
Twos  comp  of  Carry  =  1111  1111 


1  sets  S  to 
Borrow,  set  C  to  1 


1,0  1  1      110  1 


■Non-zero  result,  set  Z  to  0 
Borrow,  set  Ac  to  1 
Subtract  instruction,  set  N  to  1 


1  ¥  1  =0.  set  P/O  to  0 
The  Carry  flag  is  set  to  1  for  a  borrow  and  reset  to  0  if  there  is  no  borrow 
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SBC  A.reg  —  SUBTRACT  REGISTER  WITH  BORROW 
FROM  ACCUMULATOR 


S    Z  AqP'O  N  C 


A 
B.C 
O.E 
H,L 
SP 
PC 
IX 
lY 


I      Contents' of  A,  B, 
)-®*C,  D,  E.  H  or  L 
I       is  VY 


Data 
Memory 


Program 
Memory 


10011 XXX 


mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


SBC  A,  reg 

10011  XXX 

000  for  reg=B 

001  for  reg=C 

010  forreg=D 

01 1  for  reg=E 

100  forreg=H 

101  for  reg =L 
111  for  reg=A 

Subtract  the  contents  of  the  specified  register  and  the  Carry  status  from  the  Accumula- 
tor. 

Suppose  xx=E3i6-  Register  E  contains  AOig,  and  Carry=1.  After  the  instruction 

SBC  A,E 

has  executed,  the  Accumulator  will  contain  42ig. 

E3  =  1  1  1  0     0  0  1  1 
Two's  comp  of  AO  =  0  1  1  0     0  0  0  0 
Two's  comp  of  1   =  1  1  1  1  1111 


—  J 


0  sets  S  to  0 


No  borrow,  set  C  to  0-^— 
>  ^  


100     00  10 


Non-zero  result,  set  Z  to  0 
No  borrow,  set  Aq  to  0 
Subtract  instruction,  set  N  to  1 


1-V-1=0,  set  P/0  to  0 
The  Carry  flag  is  set  to  1  for  a  borrow  and  reset  to  0  if  there  iS  no  borrow. 
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SBC  A,{HL)  —  SUBTRACT  MEMORY  AND  CARRY  FROM 

SBC  A,{IX+disp)  ACCUMULATOR 

SBC  A,(IY+disp) 


S   Z  Ac  P/O  N  C 

f|x|x|x|x 


A 
8.C 
D,E 
H,L 
SP 
PC 
IX 
lY 


XX 

PP 

mmmm 

ppqq 


Program 
Memory 


9E 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  3 


The  illustration  shows  execution  of  SBC  A.IHL): 

SBC  A,  WD 
9E 

Subtract  the  contents  of  mennory  location  (specified  by  the  contents  of  the  HL  register 
pair)  and  the  Carry  from  the  Accumulator. 

Suppose  Carry=0.  ppqq=4000-]g,  xx=3A-|6.  and  memory  location  4000-]g  contains 
7C-|g.  After  execution  of  the  instruction 

SBC  A,{HU 

the  Accumulator  will  contain  BE-jg. 

3A  =  0  0  1  1      10  10 
Two's  comp  of7C  =  1000  0100 
Two's  comp  of  Carry  =   


1  sets  S  to  1 
Borrow,  set  C  to  1- 


 0 

Oil  1110 


Non-zero  result,  set  Z  to  0 
Borrow,  set  Ac  to  1 
Subtract  instruction,  set  N  to  1 


0V-0=0,  set  P/O  to  0 
The  Carry  flag  is  set  to  1  for  a  borrow  and  reset  to  0  if  there  is  no  borrow. 

SB£^AJX+disp) 

DD  9E  d 

Subtract  the  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the 
IX  register  and  the  displacement  value  d)  and  the  Carry  from  the  Accumulator. 

SBCjMY+disp) 
FD  9E  d 

This  instruction  is  identical  to  the  SBC  A,{IX+disp)  instruction,  except  that  it  uses  the  lY 
register  instead  of  the  IX  register. 
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SBC  HL,rp  — SUBTRACT  REGISTER  PAIR  WITH  CARRY 
FROM  H  AND  L 


S    Z  Aq  P  'O  N  C 


"■^\xxxx-vvw-C 


D.E  I 
H.L 

SP 
PC 

IX 


BC,  DE.  HL  or  SP 
contains  yyyy 
'J 


Data 
Memorv 


Program 
Memorv 


OlxxOOlO 


I  mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


SBC  HL.  rp 
01    XX  0010 


00  for  rp  is  register  pair  BC 

01  for  rp  IS  register  pair  DE 

10  for  rp  IS  register  pair  HL 

1 1  for  rp  IS  Stack  Pointer 

Subtract  the  contents  of  the  designated  register  pair  and  the  Carry  status  from  the  HL 
register  pair. 

Suppose  HL  contains  F4A2i  g,  BC  contains  A034i  g,  and  Carrv=0.  After  the  instruction 

SBC  HLBC 

has  executed,  the  HL  register  pair  will  contain  546E-|g: 

Two's  comp  of  F4A2  =  1111  0100  1010  0010 
Two's  comp  of  A034  =  0101  1111  1100  1100 
Two's  comp  of  Carry  =   0 


0  sets  S  to  0 
No  borrow,  set  C  to  0 


0 


101   0100  0110  1110 


Non-zero  result,  set  Z  to  0 
No  borrow. 


1  ¥  1  =0,  set  P/0  to  0  Subtract  instruction,  set  N  to  1 

The  Carry  flag  is  set  to  1  for  a  borrow  and  reset  to  0  if  there  is  no  borrow. 
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SCF  —  SET  CARRY  FLAG 


S   Z  Ac  P/O  N  C 

-1  I  I  M  I 


B.C 
D.E 
H,L 
SP 
PC 
IX 
lY 


Data 
Memory 


Program 
Memorv 


37 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


SCF 
37 

When  the  SCF  instruction  is  executed,  the  Cari^  status  is  set  to  1  regardless  of  its  pre- 
vious value.  No  other  statuses  or  register  contents  are  affected. 
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SET  b.reg  —  SET  INDICATED  REGISTER  BIT 

S    Z  Aq  P/O  N  c 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 


 < 

yyyy  yyyy 

mmmm 

Data 
Memory 


Program 
Memory 


CB 


1 Ibbbxxx 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


SET  b.reg 

liv 

CB  llbbb 
Bit  bbb  XXX 


000  000 

001  001 

010  010 

011  Oil 

100  100 

101  101 
110  111 
111 


Register 
B 
C 
D 
E 
H 
L 
A 


SET  indicated  bit  within  specified  register.  After  the  instruction 

SET  2,L 

has  executed,  bit  2  in  Register  L  will  be  set.  (Bit  0  is  the  least  significant  bit.) 
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SET  b,(HL)  —  SET  BIT  b  OF  INDICATED  MEMORY  POSITION 
SET  b,{IX+disp) 
SET  b,(IY+disp) 

S    2  Ac  P/O  N  C 

i  I  I  I  I  n 


A 
B.C 
D.E 
H,L 
SP 
PC 
IX 
lY 


PP 

qq 

mmrnm 

Memory 

)  1 

WW  ywy 

Program 
Memory 


CB 


11bbb1lO 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  SET  b,(HL).  Bit  0  is  the  least  significant  bit 

SET  b,(HL} 


CB  11  bbb  110 
Bit  Set 


bbb 
000 
001 
010 
Oil 
100 
101 
110 
111 


Set  indicated  bit  within  memory  location  indicated  by  HL. 
Suppose  HL  contains  4000ig.  After  the  instruction 

SET  5,(HU 

has  executed,  bit  5  in  memory  position  4000ig  will  be  1. 

SET  b,(IX+disp) 


DD  CB  d  11   bbb  110 

bbb  is  the  same  as  in  SET  b,(HU 

Set  indicated  bit  within  memory  location  indicated  by  the  sum  of  Index  Register  IX  and 
displacement. 
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Suppose  Index  Register  IX  contains  4000-|g.  After  execution  of 

SET  6.(IX+5H) 
bit  6  in  memop/  location  4005i6  will  be  1. 

SET  b,(IY+disp) 


FD  CB  d   11   bbb  110 

bbb  is  the  same  as  in  SET  b,(HL) 

This  instruction  is  identical  to  SET  b,(IX+disp!.  except  that  it  uses  the  lY  register  instead 
of  the  IX  register. 

SLA  reg  — SHIFT  CONTENTS  OF  REGISTER  LEFT  ARITHMETIC 


S    Z  AcP/O  N  C 
Ftx|X|0|X|0|7l 


A 

0,E 
H.L 
SP 
PC 
IX 
lY 


Data 
Memory 


Program 
Memory 


00100001 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  SLA  C; 

SLA  reg 

CB00100  XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

01 1  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Shift  contents  of  specified  register  left  one  bit,  resetting  the  least  significant  bit  to  0. 
Suppose  Register  B  contains  IFig,  and  Carrv=1.  After  execution  of 

SLA  B 

Register  B  will  contain  SEig  and  Carry  will  be  zero. 
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Before 
Register  B  Carry 

10  0  0  1  n  m  Q] 


0  sets  S  to  0  ■ 
5  ones,  set  P/0  to  0 


After 

Register  B  Carry 

loon  1  1  fo]  E] 


■Non-zero  result,  set  Z  to  0 


SLA  (HL)  —      SHIFT  CONTENTS  OF  MEMORY  LOCATION 
SLA  (IX+disp)  LEFT  ARITHMETIC 
SLA  (lY+dIsp) 


S    Z  Ac  P/O  N  C 

-|x|x|o|x|o|"W- 


A 
B.C 
D,E 
H.L 
SP 
PC 
IX 
lY 


PP 

qq 

mmmm 

Data 
Memory 


Program 
Memory 


CB 


26 


ppqq 


mmmm 
mmmm  -f  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  SLA  !HL): 

SLA  (HL) 
CB  26 

Shift  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register  pair)  left 
one  bit,  resetting  the  least  significant  bit  to  0. 

Suppose  the  HL  register  pair  contains  4500-|g,  memory  location  4500-|g  contains 
84-|Q,  and  Carry=0.  After  execution  of 

SLA  (HL) 

memory  location  4500-]g  will  contain  08-]  g,  and  Carry  will  be  1. 

Before  After 
Memory         Carry  Memory  Carry 

|i  000  0  1  ool    (T|     1 0 0 0 0  1  0 o"F|  \T} 


0  sets  S  to  0  ■ 
1  one,  set  P/0  to  0 


Non-zero  result,  set  Z  to  0 
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SLA  (IX+disp) 


DB  CB  a  26 

Shift  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the  IX 
register  and  the  displacement  yalue  d)  left  one  bit  arithmetically,  resetting  least  signifi- 
cant bit  to  0. 

SLA  !lY+disp) 


FD  CB  a  26 


This  instruction  is  identical  to  SLA  !lX+disp),  but  uses  the  lY  register  instead  of  the  IX 
register. 

SRA  reg  —  ARITHMETIC  SHIFT  RIGHT  CONTENTS  OF 

REQISTEB 

S    Z  Ac  P/0  N  C 

Fixtxioixioi  Vm  


A 
B.C 
O.E 
H.L 
SP 
PC 
IX 
lY 


7i-444H-+^ 

Data 
Memory 


Program 
Memory 


CB 


mmmm 


I  00101 111  I  mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  SRA  A: 

S^RA  reg 

CB  00101  XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

011  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Shift  specified  register  right  one  bit.  Most  significant  bit  is  unchanged. 
Suppose  Register  H  contains  59i6.  and  Carry=0.  After  the  instruction 

SRA  H 

has  executed.  Register  H  will  contain  2Ci6  and  Carry  will  be  1. 
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Before 
Register  H 
|0  1  0  1  1  00  1| 


C 

m 


After 
Register  H 
loo  1  0  1  1  OOl 


0  sets  S  to  0  ■ 
3  ones,  set  P/0  to  0 


C 

13 


Non-zero  result,  set  Z  to  0 


SRA  (HL)  —  ARITHMETIC  SHIFT  RIGHT  CONTENTS  OF 
SRA  (IX+disp)    MEMORY  POSITION 

SRA  (lY+disp) 


S   Z  Ac  P'O  N 


A 
B.C 
D.E 
H,L 
SP 
PC 
IX 
lY 


mmmm 

PPqq 

ppqq  +  d 


mmmm  -f  4 


Program 
Memory 

3  3  3  3  3 
3  3  3  3  3 
3  3  3  3  3 
3  3  3  3  3 
+  +  +  + 

DD 

CB 

d 

2E 

The  illustration  shows  execution  of  SRA  (IX+disp): 

SRA  (IX+disp) 


DD  CB 


Shift  contents  of  memorv  location  (specified  by  the  sum  of  the  contents  of  Register  IX 
and  the  displacement  value  d)  right.  Most  significant  bit  is  unchanged. 

Suppose  Register  IX  contains  3400-\q,  memory  location  34AAig  contains  27-\q.  and 
Carry=1.  After  execution  of 

SRA  (IX+OAAH) 

memory  location  34AAi6  will  contain  13ig,  and  Carry  will  be  1. 

Before  After 
Memory         Carry  Memorv 


00100111 


m 


000  1  00  1  11 


0  sets  S  to  0- 
3  ones,  set  P/0  to  0 


Carry 

m 


Non-zero  result,  set  Z  to  0 


3-155 


SRA  (lY+disp) 


FD  CB  a  2E 

This  instruction  is  identical  to  SRA  (IX+disp),  but  uses  the  lY  register  instead  of  the  IX 
register. 

SRA  (HL) 
CB  2E 

Shift  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register  pair) 
right  one  bit.  Most  significant  bit  is  unchanged. 

SRL  reg  — SHIFT  CONTENTS  OF  REGISTER  RIGHT 
LOGICAL 


S    Z  Aq  P/O  N  c 

Molxlolxioi  hm- 


B.cf 

H.L 
SP 
PC 

IX 

lY 


M  1  1  M  1  1 

mmmm 

Data 
Memorv 


Program 
Memorv 


CB 


00111011 


mmmm 
mmmm  +  1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  SRL  E: 

SRL  reg 

CB  00111  XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

01 1  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Shift  contents  of  specified  register  right  one  bit.  Most  significant  bit  is  reset  to  0. 
Suppose  Register  D  contains  IFig.  and  Carry=0.  After  execution  of 

SRL  D 

Register  D  will  contain  OFig,  and  Carry  will  be  1. 
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Before 
Register  D 
lOOO  1  11111 


l-arrv 

m 


After 
Register  D 
lOOOO  11111 


Carry 


4  ones,  set  P/0  to  1 


Non-zero  result,  set  Z  to  0 


SRL  (HU  —       SHIFT  CONTENTS  OF  MEMORY  LOCATION 
SRL  (IX+disp)     RIGHT  LOGICAL 
SRL  (lY+disp) 


S    Z  Ac  p/0  N  C 
F|0|X|0|X|0|  h 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


PP 

qq 

mmmm 

j 


Program 
Memory 


CB 


3E 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


The  illustration  shows  execution  of  SRL  (HU: 

SRL  !HL) 
CB  3E 

Shift  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register  pair) 
right  one  bit.  Most  significant  bit  is  reset  to  0. 

Suppose  the  HL  register  pair  contains  2000-]g.  memory  location  2000-16  contains  SF-jg. 
and  Carry=0.  After  execution  of 

SRL  (HL) 

memory  location  2000i6  will  contain  47-|6.  and  Carry  will  be  1. 

Before  After 
Memory         Carr/  Memor/  Carry 

n  00  0  1  1  iTI     [O]      I  0  1  0  0  0  1  1"T]  □] 


4  ones,  set  P/0  to  1 

SRL  (IX+disp) 


Non-zero  result,  set  Z  to  0 


DD  CB  a  3E 


Shift  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the  IX 
register  and  the  displacement  value  d)  right  one  bit  Most  significant  bit  is  reset  to  0. 
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SRL  (lY+disp) 


FD  DB  d  3E 


This  instruction  is  identical  to  SRL  (IX+disp),  but  uses  the  lY  register  instead  of  the  IX 
register. 

SUB  data  — SUBTRACT  IMMEDIATE  FROM  ACCUMULATOR 


S  Z  AqP/O  N  C 
F  I  X  I  X  I  X  I  X  I  1  I  X  1 


SUB  data 
D6  vv" 

Subtract  the  contents  of  the  second  obiect  code  byte  from  the  Accumulator. 
Suppose  xx=3Ai6-  After  the  instruction 

SUB  7CH 

has  executed,  the  Accumulator  will  contain  BEig. 

3A  =  0  0  1  1      10  10 
Two's  oomp  of  7C  =  1  000     0  1  00 
10  11  1110 


1  sets  S  to 
Borrow,  set  C  to  1 


0V0=0,  set  P/0  to  0 
Notice  that  the  resulting  carry  is  complemented. 


Non-zero  result,  set  Z  to  0 

Borrow,  set  A^  to  1 

Subtract  instruction,  set  N  to  1 
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SUB  reg  — SUBTRACT  REGISTER  FROM  ACCUMULATOR 

S   Z  Ac  P/0  N   C  ""^  Da'a 

Memory 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 
I 

R 


[X)X|X|X|1|X 

XX 

mmmm 

'  ^  Contents  of  A,  B.  C, 
r^D.  E,  H  or  L  is  yy 


Program 
Memory 


10010XXX 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


reg 

XXX 

000  for  reg=B 

001  for  reg=C 

010  forreg=D 

011  for  reg =E 

100  for  reg=H 

101  forreg=L 
111  for  reg=A 

Subtract  the  contents  of  the  specified  register  from  the  Accumulator. 

Suppose  xx=E3  and  Register  H  contains  AOiq.  After  execution  of 

SUB  H 

the  Accumulator  will  contain  43-|g. 

E3  =  1  1  1  0     0  0  1  1 
Two  s  comp  of  AO  =  0  1  1  0     0  0  0  0 


0  sets  S  to  0 
No  borrow,  set  C  to  0-« 


0 

J 


100     00  11 


1  ¥  1  =0,  set  P/0  to  0 
Notice  that  the  resulting  carry  is  complemented. 


Non-zero  result,  set  Z  to  0 
No  borrow,  set  Ac  to  0 
Subtract  instruction,  set  N  to  1 
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SUB  (HL)  —  SUBTRACT  MEMORY  FROM  ACCUMULATOR 
SUB  (IX+disp) 
SUB  (lY+disp) 


S   Z  Ac  P/O  N  C 
FlXlXlXlXn  IXI 


A 
B,C 
D.E 
H,L 
SP 
PC 
IX 
iY 


ppqq 


The  illustration  shows  execution  of  SUB  (IX+d): 

^SUBjIX+disp) 

DD  96  d 

Subtract  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the  IX 
register  and  the  displacement  value  d)  from  the  Accumulator. 

Suppose  ppqq=4000i6.  xx=FFi6.  and  memon/  location  40FFie  contains  bO-[Q.  After 
execution  of 

SUB  (IX+OFFH! 
the  Accumulator  will  contain  AFiq. 

FF  =  1  1  1  1  1111 
Two's  comp  of  50  =  1  0  1  1  0000 


1  sets  S  to  1 
No  borrow,  set  C  to  0 


0  10  1111 


t 


Non-zero  result,  set  Z  to  0 
No  borrow,  set  Ac  to  0 
Subtract  instruction,  set  N  to  1 


1  ¥  1  =0,  set  P/O  to  0 
Notice  that  the  resulting  carry  is  complemented. 

SUB  SlY+disp) 

FD  96  d 

This  instruction  is  identical  to  SUB  (IX+disp).  except  that  it  uses  the  IY  register  instead 
of  the  IX  register. 


Subtract  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register  pair) 
from  the  Accumulator. 
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XOR  data  —  EXCLUSIVE-OR  IMMEDIATE  WITH  ACCUMULATOR 

S    Z  AcP/O  N  C 


A 
B,C 
D.E 
H.L 
SP 
PC 
IX 
lY 


XX 

mmmm 

XOR 

Data 
Memorv 


Program 
Memory 


EE 


mmmm 
mmmm  1 
mmmm  +  2 
mmmm  +  3 


data 


vy 


Exclusive-OR  the  contents  of  the  second  obiect  code  byte  with  the  Accunnulator. 
Suppose  xx=3AiQ.  After  the  instruction 

XOR  7CH 

has  executed,  the  Accumulator  will  contain  46ig. 

3A  =  0  0  1  1  10  10 
7C  =  0  1  11  1100 


0  sets  S  to  0 


0  100     0  110 

il 

-Non-zero  result,  set  Z  to  0 

-Three  1  bits,  set  P/0  to  0 
The  Exolusive-OR  instruction  is  used  to  test  for  changes  in  bit  status. 
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XOR  reg  —  EXCLUSIVE-OR  REGISTER  WITH  ACCUMULATOR 

S    Z  Ac  P/O  N  C 


A 
B.C 
D.E 
H.L 
SP 
PC 
IX 
lY 


K Contents  of  A, 
C,  D,  E,  H  or  L 
IS  yy 


Data 
Memory 


Program 
Memory 


10101XXX 


mmmm 
mmmm  + 1 
mmmm  +  2 
mmmm  +  3 


reg 

XXX 

000  for  reg=B 

001  for  reg=C 

010  for  reg=D 

01 1  for  reg=E 

100  for  reg=H 

101  for  reg=L 
111  for  reg=A 

Exclusive-OR  the  contents  of  the  specified  register  mth  the  Accumulator. 
Suppose  xx=E3i6  and  Register  E  contains  AOig-  After  the  instruction 

XOR  E 

has  executed,  the  Accumulator  will  contain  43-ig. 

E3  =  1  1  1  0     0  0  1  1 


AO 


10  10  0000 


0  100 


0  sets  S  to  0 


00  11 

4 


-Non-zero  result,  set  Z  to  0 


-Three  1  bits,  set  P/0  to  0 
The  Exclusive-OR  instruction  is  used  to  test  for  changes  in  bit  status. 
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XOR  (HL)  —  EXCLUSIVE-OR  MEMORY  WITH  ACCUMULATOR 
XOR  (IX+disp) 
XOR  (lY+disp) 

S   Z  Ac  P/O  N  C 


The  illustration  shows  execution  of  XOR  (IX+dispj: 

^XOR  flX+disp) 

DD  AE  d 

Exclusive-OR  contents  of  memory  location  (specified  by  the  sum  of  the  contents  of  the 
IX  register  and  the  displacement  value  d)  with  the  Accumulator. 

Suppose  xx=E3i6.  ppqq=4500ig,  and  memory  location  45FFig  contains  AOig-  After 
the  instruction 

XOR  (IX+OFFH) 

has  executed,  the  Accumulator  will  contain  43ig. 

E3  =  1  1  1  0  0  0  11 
AO  =  1010  0000 


0  sets  S  to 


0-^ — ^ 


0  100 


00  11 
k 


-Non-zero  result,  set  Z  to  0 


-Three  1  bits,  set  P/O  to  0 


XOR  (lY+disp) 


FD  AE 


This  instruction  is  identical  to  XOR  (IX+disp),  except  that  it  uses  the  lY  register  instead 
of  the  IX  register. 


Exclusive-OR  contents  of  memory  location  (specified  by  the  contents  of  the  HL  register 
pair)  with  the  Accumulator. 
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8080A/Z80 

COMPATIBILITY 

FEATURES 


8080A/Z80  COMPATIBILITY 

Although  the  Z80  microprocessor  can  certainly  be  used  on 
Its  own  merits,  one  of  its  important  characteristics  is  its 
compatibility  with  the  8080A  microprocessor.  This  com- 
patibility has  the  following  features: 

1)  All  8080A  machine  language  instructions  are  also  Z80  machine  language  instruc- 
tions. 

2)  All  8080A  registers  are  also  Z80  registers  (see  Table  3-6). 

3)  Almost  all  8080A  programs  will  run  on  a  Z80.  with  some  minor  differences  to  be 
noted  later. 

4)  The  Z80  has  instructions,  registers,  and  other  features  not  present  on  the  8080A, 
so  Z80  programs  will  not  generally  run  on  8080A  processors. 

Note  that  this  compatibility  does  not  extend  to  assembly 
language  source  statements  since  Z80  assemblers  and  8080A 
assemblers  use  different  operation  code  mnemonics.  Table  3-7 
contains  a  list  of  the  8080A  mnemonic  codes  and  the  corres- 
ponding Z80  codes,  while  Table  3-8  is  the  same  list  organized 
by  Z80  codes. 

Readers  should  note  the  binary  coding  limitations  that  this  com- 
patibility places  on  the  extra  features  of  the  Z80  microprocessor. 
The  8080A  has  some  unused  operation  codes  (see  Table  3-9)  that 
are  used  for  some  of  the  Z80's  extra  instructions.  But  there  are 
simply  not  enough  such  codes  to  cover  the  large  number  of 
features  in  a  simple  form. 

Thus,  many  of  the  added  Z80  instructions  require  a  2-byte  opera- 
tion code.  The  first  byte  is  CB,  DD.  ED,  or  FD.  Note  the  following 
meanings  of  these  codes  from  Table  3-9: 


8080A/Z80 
ASSEMBLY 
LEVEL 

CONVERSION 


8080A 
UNUSED 
OPERATION  I 
CODES 


2-BYTE 

OPERATION 

CODES 


CB  —  a  register  or  bit  operation 

DD  —  an  operation  involving  register  IX 

ED  —  a  miscellaneous  non-8080A  instruction  not  covered  elsewhere 
FD  —  an  operation  involving  register  lY 
The  second  byte  of  the  operation  code  describes  the  actual  operation  to  be  performed 

The  end  result  is  that  these  multi-byte  instructions  execute  rather 
slowly  (and  use  more  memory)  because  an  additional  memory 
access  is  required.  The  reader  should  be  aware  of  this  variation  in 
execution  times  and  try  to  use  faster  executing  instructions  when 
possible.  This  warning  particularly  applies  to  the  extra  shift 
instructions  (RLC,  RRC,  RL.  RR.  SRA,  SRL)  and  to  instructions  involving  the  index 
registers  IX  and  lY. 


FASTER  AND 
SLOWER 
EXECUTING 
INSTRUCTIONS 


8080A/Z80 
INCOMPATIBILITIES} 

The  Z80  uses  the  P  (or  P/0)  flag  to  indicate  twos  com- 
plement overflow  after  arithmetic  operations.  The  8080A  always  uses  this  flag  for 
parity. 

The  Z80  and  8080A  execute  the  DAA  instruction  differently.  On  the  Z80,  this  in- 
struction will  correct  decimal  subtraction  as  well  as  decimal  addition.  On  the 
8080A.  It  will  correct  only  decimal  addition. 
3)    The  Z80  rotate  instructions  clear  the  Aq  flag.  The  8080A  rotate  instructions  do 
not  affect  the  Ac  flag. 


There  are  a  few  minor  incompatibilities  between  the 
8080A  and  the  Z80.  These  are: 

1) 


2) 
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Table  3-6.  Register  and  Flag  Correspondence  between 
Z80  and  8080A 


Z80  Register 

8080A  Register 

A 

A 

A' 

None 

B 

B 

8' 

None 

C 

C 

C 

None 

D 

D 

D' 

None 

E 

E 

E" 

None 

F 

Least  Significant  Half  of  PSW 

F' 

None 

H 

H 

H' 

1 

None 

iX 

None 

!Y 

None 

L 

L 

L' 

None 

R 

PC 

PC 

SP 

SP 

Z80  Register  Pairs 

8080A  Register  Pairs 

8C 

B 

DE 

D 

HL 

H 

AF 

PSW 

Z80  Flags 

8080A  Flags 

C  (Carryt 

C  (Carrv) 

H  {Half-Carrv) 

AC  (Auxiliary  Carry) 

N  {Subtract) 

None 

P/0  (Paiitv/Overflow) 

P (Parity) 

S  (Sign) 

S  (Sign) 

Z  (Zero) 

Z  (Zero) 

The  Z80  is  not  compatible  with  the  extra  features  of  8085/Z80 

the  8085  microprocessor.  The  codes  used  for  RIM  and  |INCOMPATIBILITIES 

SIM  on  the  8085  are  used  for  relative  jumps  !NZ  and  NC)  on 
the  Z80. 

Instruction  timings  on  the  8080A,  8085,  and  Z80  all 
differ.  Programs  that  depend  on  precise  instruction  tim- 
ings will  therefore  execute  properly  only  on  the  pro- 
cessor for  which  they  were  written. 

The  N  flag  on  the  Z80  occupies  bit  2  of  the  F  register;  the  corresponding  bit  in  the 
Processor  Status  Word  of  the  8080A  is  always  a  logic  '1'. 


TIMING 

INCOMPATIBILITIES 
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Table  3-7  Correspondence  between  8080A  and  Z80  Mnemonics 


8080A  Mnemonic 

Z80  Mnemonic 

ACI 

ADC 

A  data 

ADC 

reg  or  M 

ADC 

A.reg  or  (HL) 

ADD 

rag  or  M 

ADD 

A, reg  or  iHL) 

ADI 

ADD 

ANA 

r6g  or  M 

AND 

rag  or  (HL) 

ANi 

AND 

CALL 

aS 

CALL 

addr 

CC 

addr 

CAU- 

Caddr 

CM 

addr 

CALL 

M.addr 

CMA 

CPL 

CMC 

CCF 

CMP 

rog  or  M 

CP 

rsg  or  (HL) 

CNC 

CALL 

NC.addr 

CNZ 

addr 

CALL 

NZ.addr 

CP 

addr 

CALL 

P.addr 

CPE 

addr 

CALL 

PE.addr 

CPI 

data 

CP 

data 

CPO 

addr 

CALL 

PO.addr 

CZ 

addr 

CALL 

Z.addr 

DAA 

DAA 

DAD 

TP 

ADD 

HL,rp 

OCR 

rog  or  M 

DEC 

reg  or  (HL) 

DCX 

rp 

DEC 

D! 

Di 

Ei 

Ei 

HIT 

HALT 

IN 

port 

IN 

A.lport) 

INR 

reg  or  M 

INC 

reg  or  (HL) 

INX 

iNC 

JC 

addr 

JP 

Caddr 

JM 

JP 

M,addr 

JMP 

addr 

JP 

addr 

JNC 

addr 

JP 

NC.addr 

JP 

addr 

JP 

P.addr 

JNZ 

addr 

JP 

NZ.addr 

JPE 

addr 

JP 

PE.addr 

JPO 

addr 

JP 

PO.addr 

JZ 

addr 

JP 

Z.addr 

LDA 

addr 

LD 

A.laddrl 

LDAX 

B  or  D 

LD 

A,(BC)  or  IDE) 

8080A  Mnemonic 

Z80  Mnemonic 

LHLD 

addr 

LD 

HL,(addr) 

LXI 

rp,data16 

LD 

rp,data16 

MOV 

reg.reg  or  M 

LD 

reg.reg  or  (HLS 

MOV 

reg  or  M.rag 

LD 

reg  or  (HD.reg 

MVI 

reg  or  M.data 

LD 

reg  or  IHD.data 

NOP 

NOP 

ORA 

reg  or  M 

OR 

reg  or  (HL) 

ORI 

data 

OR 

data 

OUT 

OUT 

{port),A 

PCHL 

JP 

(HU 

POP 

pr 

POP 

pr 

PUSH 

pr 

PUSH 

pr 

RAL 

RLA 

RAR 

RRA 

RC 

RET 

C 

RET 

RET 

RLC 

RLCA 

RM 

RET 

M 

RNC 

RET 

NC 

RNZ 

RET 

NZ 

RP 

RET 

P 

RPE 

RET 

PE 

RPO 

RET 

PC 

RRC 

RRCA 

HST 

n 

RST 

n 

RZ 

RET 

Z 

SBB 

reg  or  M 

SBC 

A.reg  or  (HU 

SBI 

data 

SBC 

A.data 

SHLD 

addr 

LD 

(addr),HL 

SPHL 

LD 

SP.HL 

STA 

LD 

(addr),A 

STAX 

B  or  D 

LD 

(BCl  or  (DE),A 

STC 

SCF 

SUB 

reg  or  M 

SUB 

rag  or  (HL) 

SUI 

data 

SUB 

data 

XCHG 

EX 

DE.HL 

XRA 

reg  or  M 

XOR 

reg  or  (HL) 

XRI 

data 

XOR 

data 

XTHL 

EX 

(SP),HL 
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Table  3-8.  Correspondence  between  Z80  and  8080A  Mnemonics 


Z80  Mnsmonic 

8080A  Mnemonic 

ADC 

A,data 

ACI 

data 

ADC 

A,(HL) 

ADC 

M 

ADC 

A.reg 

ADC 

reg 

ADC 

A.{xy  +  disp) 

— 

ADC 

HL,rp 

— 

ADD 

A.data 

ADI 

data 

ADD 

A.IHU 

ADD 

M 

ADD 

A.reg 

ADD 

reg 

ADD 

A,{xv  +  disp} 

— 

ADD 

HL,rp 

Bad 

rp 

ADD 

IX.pp 

— 

ADD 

lY.rr 

— 

AND 

data 

ani 

data 

AND 

(HLl 

ANA 

M 

AND 

reg 

ANA 

reg 

AND 

(xy  +  disp} 

— 

BIT 

b.lHLl 

— 

BIT 

b.reg 

— 

BIT 

b,(xy  +  disp) 

— 

addr 

CALL 

addr 

CALL 

CALL 

C.addr 

CC 

addr 

CALL 

M.addr 

CM 

addr 

CALL 

NC.addr 

CNC 

addr 

CALL 

NZ,addr 

CNZ 

addr 

CALL 

P.addr 

CP 

addr 

CALL 

PE.addr 

CPE 

addr 

CALL 

P0,addr 

CPO 

addr 

CALL 

Z.addr 

CZ 

addr 

CCF 

CMC 

CP 

data 

CPI 

data 

CP 

(HU 

CMP 

M 

CP 

reg 

CMP 

reg 

CP 

(xy  +  disp) 

— 

CPD 

— 

CPDR 

— 

CPI 

— 

CPIR 

— 

CPL 

CMA 

DAA 

DAA 

DEC 

(HU 

DCR 

M 

DEC 

reg 

DCR 

reg 

DEC 

rp 

OCX 

rp 

DEC 

XV 

— 

DEC 

{xy  +  disp) 

— 

Dl 

Dl 

DJNZ 

disp 

— 

El 

El 

EX 

AF.AF 

EX 

DE.HL 

XCHG 

EX 

(SPl.HL 

XTHL 

EX 

(SP),xv 

EXX 

HALT 

HLT 

IM 

m 

IN 

A.Cport) 

IN 

port 

IN 

reg.lC) 

INC 

(HU 

INR 

M 

INC 

reg 

INR 

reg 

—  indicates  that  there  is  no  corresponding  instructron. 


Z80  Mnemonic 

8080A  Mnemonic 

INC 

rp 

INX 

rp 

INC 

xy 

— 

INC 

(xv  +  disp) 

— 

IND 

— 

INDR 

— 

INI 

— 

INIR 

— 

JP 

addr 

JMP 

addr 

JP 

C.addr 

JC 

addr 

JP 

(HLl 

PCHL 

JP 

M.addr 

JM 

addr 

JP 

NC.addr 

JNC 

addr 

JP 

NZ.addr 

JNZ 

addr 

JP 

P.addr 

JP 

addr 

JP 

PE.addr 

JPE 

addr 

JP 

PO.addr 

JPO 

addr 

JP 

Z.addr 

JZ 

addr 

JP 

xy 

— 

JR 

C.disp 

— 

JR 

disp 

— 

JR 

NC.disp 

— 

JR 

NZ.disp 

— 

JR 

Z.disp 

— 

LD 

A.(addrl 

LDA 

addr 

LD 

A.(BC)  or  (DE) 

LDAX 

B  or  D 

LD 

A,l 

— 

LD 

A,R 

— 

LD 

(addrlA 

STA 

addr 

LD 

(addr),BC  or  DE 

— 

LD 

(addr).HL 

SHLD 

addr 

LD 

(addrl.SP 

— 

LD 

(addr),xy 

— 

LD 

(BC)  or  (DEl.A 

STAX 

B  or  D 

LD 

BC  or  DE,(addr) 

— 

LD 

HLIaddrl 

LHLD 

addr 

LD 

(HUdata 

MVI 

M.data 

LD 

(HU.reg 

MOV 

M.reg 

LD 

l,A 

— 

LD 

R.A 

— 

LD 

reg.data 

MVI 

rag.data 

LD 

reg,(HU 

MOV 

reg.M 

LD 

reg.reg 

MOV 

reg.reg 

LD 

reg,(xy  +  disp) 

— 

LD 

rp,data16 

LXI 

rp,data16 

LD 

SP,(addr) 

— 

LD 

SP.HL 

SPHL 

LD 

SP.xy 

— 

LD 

xy,data16 

— 

xy,(addr) 

LD 

(xv  +  disp),data 

LD 

(xy  -f  d!sp),reg 

LDD 

LDDR 

LOI 

LDIR 

NEC 

NOP 

NOP 

OR 

data 

ORI 

data 
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Table  3-8.  Correspondence  between  Z80  and  8080A  Mnemonics  (Continued) 


Z80  Mnemonic 

8080A  Mnemonic 

OR 

(HL) 

ORA  M 

OR 

reg 

ORA  reg 

OR 

{xv  +  disp) 

— 

OTDR 

OTIR 

OUT 

{CS.reg 

OUT 

{portf.A 

OUT  port 

OUTD 

OUTI 

_ 

POP 

pr 

POP  pr 

POP 

XV 

PUSH 

pr 

PUSH  pr 

PUSH 

xy 

RES 

b.iHU 

RES 

b,reg 

RES 

bjxy  +  dispi 

_ 

RET 

RET 

RET 

C 

RC 

RET 

M 

RM 

R^ 

NC 

RNC 

RET 

NZ 

RNZ 

RET 

P 

RP 

RET 

PE 

RPE 

RET 

PO 

RPO 

RET 

Z 

RZ 

RET! 

— 

RETN 

RL 

(HU 

RL 

reg 

RL 

(xy  +  disp) 

RLA 

RAL 

RLC 

!HL) 

RLC 

reg 

RLC 

{xv  +  displ 

RLCA 

RLC 

RLD 

Z80  Mnemonic 

8080A  Mnemonic 

RR 

(HL) 

RR 

reg 

RR 

(xy  +  disp) 

RRA 

RAR 

RRC 

(HL) 

RRC 

reg 

RRC 

(xv  +  disp) 

RRCA 

RRC 

RRD 

RST 

n 

RST 

n 

SBC 

A,data 

SBl 

data 

SBC 

A,(HL) 

5BB 

M 

SBC 

A.reg 

SBB 

rag 

SBC 

A,(xy  +  disp) 

SBC 

HL,tp 

SCF 

STC 

SET 

b,(HL) 

SET 

b.reg 

SET 

b,{xv  disp) 

SLA 

(HL) 

SLA 

reg 

SLA 

(xy  disp) 

SRA 

(HL) 

SRA 

reg 

SRA 

(xy  disp) 

SRL 

(HU 

I 

SRL 

reg 

SRL 

(xy  +  disp) 

SUB 

data 

SUI 

data 

SUB 

(HU 

SUB 

M 

SUB 

reg 

SUB 

reg 

SUB 

(xy  +  disp) 

XOR 

data 

XRI 

data 

XOR 

(HU 

XRA 

M 

XOR 

reg 

XRA 

reg 

XOR 

(xy  +  disp) 

-  indicates  that  there  is  no  con-esponding  instruction 
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Table  3-9.  Unused  8080A  Operation  Codes  and  Their  Z80  Mean 


lings 


8080A  Operation  Code 


Z80  Use 


20  (RIM  on  80851 
28 

30  (SIM  on  8085) 

38 

CB 

D9 

DD 

ED 


EX  AF.AF' 
DJN7  disp 
JR  disp 
JR  NZ.disp 
JR  Z.disp 
JR  NC.disp 
JR  Cdisp 

BIT  RES.  RL.  RLC.  RR.  RRC.  SET.  SLA.  SRA,  SRL 
EXX 

Alt  instructions  involving  Register  IX. 


ADC 

HL.rp 

LD 

A.I 

NEG 

CPD 

LP 

A.R 

OTDR 

CPDR 

LD 

(addri.rp 

OTIR 

CPI 

LD 

I.A 

OUT 

CPIR 

LD 

R.A 

OUTD 

IM 

m 

LD 

rp,(addrl 

OUTI 

IN 

reg,(C) 

LDD 

RETI 

IND 

LDDR 

RETN 

INDR 

LDI 

RLD 

INI 

LDIR 

RRD 

INIR 

SBC 

All  instructions  involving  Register  !Y. 
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ZILOG  Z80  ASSEMBLER  CONVENTIONS 


The  standard  Z80  assembler  is  available  from  Z80  manufacturers  and  on  the  major 
time-sharing  networks;  it  is  also  part  of  most  development  systems.  Cross  assem- 
bler versions  are  available  for  most  large  computers  and  many  minicomputers. 

ASSEMBLER  FIELD  STRUCTURE 

The  assembly  language  instructions  have  the  standard  field  structure  (see  Table 
2-1).  The  required  delimiters  are: 

1)  A  colon  after  a  label,  except  for  the  pseudo-operations  EQU,  DEFL,  and 
MACRO,  which  require  a  space. 

2)  A  space  after  the  operation  code. 

3)  A  comma  between  operands  in  the  operand  field.  (Remember  this  one!) 

4)  A  semicolon  before  a  comment. 

5)  Parentheses  around  memory  references. 

Typical  Z80  assembly  language  instructions  are: 

START:     LD  A,(1000)        ;GET  LENGTH 

ADD  HLDE 
HALT 

LABELS 

The  assembler  allows  six  characters  in  labels;  the  first  character  must  be  a  letter, 
while  subsequent  characters  must  be  letters,  numbers,  ?,  or  the  underbar 
character  (J.  We  will  use  only  capital  letters  or  numbers,  although  some  versions 
of  the  assembler  allow  lower-case  letters  and  other  symbols. 

RESERVED  NAMES 

Some  names  are  reserved  as  keywords  and  should  not  be  used  by  the  program- 
mer. These  are  the  register  names  (A,  B,  C,  D,  E,  H,  L,  I,  R),  the  double  register 
names  (IX,  lY,  SP),  the  register  names  (AF,  BC,  DE,  HL,  AF',  BC  DE',  HL'),  and 
the  states  of  the  four  testable  flags  (C,  NC,  Z,  NZ.  M,  P,  PE,  PO). 

PSEUDO-OPERATIONS 

The  assembler  has  the  following  basic  pseudo-operations: 


DEFB 

DEFINE  BYTE 

DEFL 

DEFINE  LABEL 

DEFM 

DEFINE  STRING 

DEFS 

DEFINE  STORAGE 

DEFW  - 

DEFINE  WORD 

END 

END 

EQU 

EQUATE 

ORG 

ORIGIN 

DEFB,  DEFM,  and  DEFW  are  the  Data  pseudo-operations  used  to 
place  data  in  ROM.  DEFB  is  used  for  8-bit  data.  DEFW  for  16-bit 
data,  and  DEFM  for  ASCII  strings  (63  or  less  characters  long).  The 
only  unusual  feature  to  remember  is  that  DEFW  stores  the  eight 
least  significant  bits  of  data  in  the  first  word  and  the  eight  most 
significant  bits  in  the  second  word.  This  is  the  standard  8080A/8085/Z80  procedure  for 
storing  addresses  in  memory,  but  is  contrary  to  normal  practice.  You  must  be  aware  of 
the  order  when  storing  16-bit  data. 


DEFB,DEFM, 
DEFW 
PSEUDO- 
OPERATIONS 
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Note  that  DEFB  and  DEFW  define  the  value  of  only  a  single  bvte  or  single  word,  respec- 
tively. Establishing  a  table  of  values  requires  a  series  of  DEFB  or  DEFW  pseudo-opera- 
tions, one  for  each  byte  or  word  of  data. 

Examples: 

ADDR:     DEFW  3165H 

results  in  (ADDR)  =65,  and  (ADDR+I)  =31  (hexadecimal). 
TCONV:    DEFB  32 

This  pseudo-operation  places  the  number  32  in  the  next  byte  of  ROM  and  assigns  the 
name  TCONV  to  the  address  of  that  byte. 

ERROR:    DEFM  'ERROR' 

This  pseudo-operation  places  the  7-bit  ASCII  characters  E.  R,  R.  0,  and  R  in  the  next  five 
bytes  of  ROM  and  assigns  the  name  ERROR  to  the  address  of  the  first  byte. 

OPERS:  DEFW  FADD 
DEFW  FSUB 
DEFW  FMUL 
DEFW  FDIV 

This  senes  of  pseudo-operations  places  the  addresses  FADD.  FSUB.  FMUL.  and  FDIV  in 
the  next  eight  bytes  of  memory  and  assigns  the  name  OPERS  to  the  address  of  the  first 
byte.  Note  that  the  first  byte  contains  the  least  significant  bits  of  address  FADD. 

DEFS  IS  the  Reserve  pseudo-operation  used  to  assign  locations  in 
RAM;  it  allocates  a  specified  number  of  bytes. 


DEFS 
PSEUDO- 
OPERATION 


EQU 

PSEUDO- 
OPERATION 


DEFL 
PSEUDO- 
OPERATION 


EQU  IS  the  Equate  or  Define  pseudo-operation  used  to  assign 
values  to  names. 

DEFL  IS  similar  to  EQU,  except  that  DEFL  allows  the  name  to  be 
redefined  later.  DEFL  is  much  like  the  SET  directive  in  other  as- 
semblers, it  should  only  be  used  to  define  assembly  time  variables 
(i.e.,  those  variables  used  in  conditional  assembly  or  conditional 
macro  expansion  statements). 

ORG  IS  the  standard  Ongin  pseudo-operation. 

Z80  programs  usually  have  several  origins;  the  origins  are  used  as 
follows: 

1)  To  specify  the  RESET  address  (usually  zero). 

2)  To  specify  interrupt  entry  points  (usually  0  to  66i  g  but  may  be  anywhere  in  memo- 
n/. 

3)  To  specify  the  starting  address  of  the  mam  program. 

4)  To  specify  the  starting  addresses  of  subroutines. 

5)  To  define  areas  for  RAM  storage. 

6)  To  define  an  area  for  the  RAM  Stack. 

7)  To  specify  addresses  used  for  I/O  ports  and  special  functions. 


ORG 

PSEUDO- 
OPERATION 
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Examples: 

RESET      EQU  0 

ORG  RESET 

This  sequence  places  the  RESET  instruction  sequence  in  memory  beginning  at  address 
0. 

1NT1         EQU  38H 
ORG  INT1 

The  instruction  sequence  that  follows  is  stored  in  memory  beginning  at  location  38 ig- 
END  simply  marks  the  end  of  the  assembly  language  program. 

The  special  purpose  pseudo-operations  COND.  MACRO,  ENDC, 
and  ENDM  are  described  later  in  this  chapter. 

LABELS  WITH  PSEUDO-OPERATIONS 

The  rules  and  recommendations  for  labels  with  Z80  pseudo-operations  are  as 
follows: 

1)  EQU.  DEFL.  and  MACRO  require  labels,  since  the  function  of  these  pseudo-opera- 
tions IS  to  define  the  meaning  of  that  label. 

2)  DEFB,  DEFM.  DEFW.  and  DEFS  usually  haye  labels. 

3)  ORG,  COND,  ENDC,  ENDM,  and  END  should  not  haye  labels,  since  the  meaning  of 
such  labels  is  unclear. 

ADDRESSES 

The  Zilog  Z80  assembler  allows  entries  in  the  address  field  in  any 
of  the  following  forms: 

1)  Decimal  (the  default  case) 
Example:  1247 

2)  Hexadecimal  (must  start  with  a  digit  and  end  with  an  H) 
Examples:  142CH.  0E7H 

3)  Octal  (must  end  with  0  or  Q,  but  Q  is  far  less  confusing) 
Example:  1247Q  or  12470 

4)  Binary  (must  end  with  B) 
Example:  10010010001 11B 

5)  ASCII  (enclosed  in  single  quotation  marks) 
Example:  'HERE' 

6)  As  an  offset  from  the  Program  Counter  ($) 
Example:  $-f237H 

All  arithmetic  and  logic  operations  within  an  address  field  assume 
all  arguments  are  16-bit  data;  they  produce  16-bit  results.  These 
operations  are  allowed  as  part  of  expressions  in  the  address  field. 

When  defining  address  constants,  hexadecimal  notation  should 
be  used.  Binary  constants  of  16  bits  are  unwieldy  and  hence  error- 
prone.  Octal  constants  are  inconvenient  due  to  the  fact  that  addresses  are  stored  in 
low-order  byte  high-order  byte  format.  This  division  occurs  in  the  middle  of  an  octal 
digit,  which  causes  you  to  have  to  split  a  digit.  For  example,  to  express  the  address 
9D7FH  or  1 165770  in  low-high  format  you  get  7F9DH  or  77236Q.  As  you  can  see,  in 
hexadecimal  notation  the  digits  are  simply  transposed,  while  no  such  simple  relation- 
ship exists  for  octal  notation. 


END 

PSEUDO- 
OPERATION 


NUMBERS  AND 
CHARACTERS 
IN  ADDRESS 
FIELD 


ASSEMBLER 
ARITHMETIC 
AND  LOGICAL 
OPERATIONS 
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ODCD  A  TOD 

UrbnA  I  UH 

rUNC  riUN 

PRIORITY 

+ 

UNARY  PLUS 

1 

UNARY  MINUS 

1 

.NOT.  or  \ 

LOGICAL  NOT 

1 

.RES. 

RESULT 

1 

EXPONENTIATION 

2 

• 

MULTIPLICATION 

3 

/ 

DIVISION 

3 

.MOD. 

MODULO 

3 

.SHR. 

LOGICAL  SHIFT  RIGHT 

3 

.SHL 

LOGICAL  SHIFT  LEFT 

3 

+ 

ADDITION 

4 

SUBTRACTION 

4 

.AND.  or  8 

LOGICAL  AND 

5 

.OR.  or  f 

LOGICAL  OR 

6 

XOR. 

1  nfilPAl  XDR 

Q 

.EQ.  or  = 

EQUALS 

7 

.GT.  or  > 

GREATER  THAN 

7 

.LT.  or  < 

LESS  THAN 

7 

.UGT. 

UNSIGNED  GREATER  THAN 

7 

.ULT. 

UNSIGNED  LESS  THAN 

7 

In  address  expressions  with  more  than  one  operator,  the  order  of  evaluation  is  defined 
by  the  priorities  given  in  the  list  above.  Operators  having  the  same  priorities  are  evalu- 
ated from  left  to  right.  Expressions  in  parentheses  are  evaluated  first  Remember  that 
enclosing  an  expression  entirely  in  parentheses  indicates  a  memory  address. 

Note  the  following: 

II  The  Result  operator  (.RES.)  causes  overflow  to  be  suppressed:  i.e.,  a  change  in  sign 
caused  by  overflow  into  the  sign  bit  does  not  result  in  an  assembler  error. 

2)  The  shifts  have  the  form: 

.SHR.  op1,op2 
.SHL.  op1,op2 

where  opi  is  the  number  to  be  shifted  and  op2  is  the  number  of  shifts.  The  shifts 
are  logical,  i.e..  zeros  are  shifted  into  the  high-order  or  low-order  bits,  respectively. 

3)  The  comparison  operators  produce  a  result  of  either  logical  True  (all  ones)  or  logical 
False  (zero). 

41  The  operators  ,GT.  and  .LT.  assume  signed  twos  complement  numbers,  whereas 
.UGT.  and  .ULT.  assume  unsigned  operands.  This  means  that,  for  .GT.  and  .LT., 
positive  twos  complement  numbers  are  larger  than  negative  twos  complement 
numbers,  while  the  opposite  is  the  case  for  .UGT.  and  .ULT. 
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CONDITIONAL  ASSEMBLY 


The  Z80  assembler  has  a  simple  conditional  assembly 
capability  based  on  the  pseudo-operations  COND  and  ENDC. 

COND  IS  followed  by  an  expression,  for  example: 

COND     BASE  -  1000H 
or 

COND     BASE  -  OPERl 

If  ttie  expression  is  not  zero,  ttie  assembler  includes  all  of  the  instructions  up  to  the 
ENDC  pseudo-operation  in  the  program;  if  the  expression  is  zero,  the  assembler  ignores 
all  instructions  between  COND  and  ENDC. 

We  will  not  use  conditional  assemblies  or  refer  to  this  capability  again;  it  is  sometimes 
handy  for  adding  or  eliminating  debugging  instructions,  or  configuring  unique  versions 
of  a  common  program. 

MACROS 

The  standard  Z80  assembler  has  a  macro  capability  that 
assigns  names  to  instruction  sequences.  Use  the  pseudo-opera- 
tion MACRO  to  begin  the  definition  and  ENDM  to  end  it.  The 
macro  may  haye  parameters  and  may  include  any  assembly 
language  instructions  except  the  definitions  of  other  macros. 

The  macro  capability  is  often  a  convenient  programming  shorthand,  but  we  will  not  use 
It. 

Note  that  instruction  sequences  defined  by  macros  are  generally  quite  short;  they 
should  not  exceed  ten  or  fifteen  instructions.  Longer  sequences  should  be  made  into 
subroutines  to  conserve  memory  space. 

Every  MACRO  pseudo-operation  must  have  a  label;  the  label  is  the  name  with  which 
you  identify  the  macro.  For  a  discussion  of  this  subiect,  see  Chapter  2. 


COND  AND 
ENDC 
PSEUDO- 
OPERATIONS 


MACRO  AND 
ENDM 
PSEUDO- 
OPERATIONS 
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Chapter  4 
SIMPLE  PROdRAMS 


The  only  way  to  learn  assembly  language  programming  is  to  write  assembly 
language  programs.  That  is  what  we  will  do  for  the  next  six  chapters,  which  con- 
tain examples  of  typical  microprocessor  tasks.  Problems  at  the  end  of  each 
chapter  contain  variations  on  the  examples  given  in  the  text  of  the  chapter.  You 
should  try  to  run  the  examples  on  a  Z80-based  microcomputer  system  to  ensure 
that  you  understand  the  material  covered  in  the  chapter. 

In  this  chapter  we  begin  with  sonne  very  simple  programs. 

GENERAL  FORMAT  OF  EXAMPLES 

Each  program  example  contains  the  following  parts: 

1)  A  title  that  describes  the  general  problem. 

2)  A  statement  of  purpose  which  describes  the  specific  task  that 
the  program  performs,  plus  the  memory  locations  that  it  uses. 

3)  A  sample  problem  showing  input  data  and  results. 

4)  A  flowchart  if  the  program  logic  is  complex. 

5)  The  source  program  or  assembly  language  listing  of  the  program. 

6)  The  object  program  or  hexadecimal  machine  language  listing  of  the  program. 

7)  Explanatory  notes  that  discuss  the  instructions  and  methods  used  in  the  program. 

The  problems  at  the  end  of  the  chapter  are  similar  to  the  examples;  problems 
should  be  programmed  on  a  Z80-based  microcomputer  system  using  the  examples 
as  guidelines. 

The  source  programs  in  the  examples  haye  been  constructed  as  follows: 

1)  Standard  Zilog  Z80  assembler  notation  is  used,  as  sum- 
marized in  Chapter  3. 

2)  The  forms  in  which  data  and  addresses  appear  are  selected  for 
clarity  rather  than  for  consistency.  We  use  hexadecimal  num- 
bers for  memory  addresses,  instruction  codes,  and  BCD  data;  decimal  for  numeric 
constants;  binary  for  logical  masks;  and  ASCII  for  characters. 

3)  Frequently  used  instructions  and  programming  techniques  are  emphasized. 

4)  Examples  illustrate  tasks  that  microprocessors  perform  in  communications,  instru- 
mentation, computer,  business  equipment,  industrial,  and  military  applications. 

5)  Detailed  comments  are  included. 

6)  Simple  and  clear  structures  are  emphasized,  but  programs  are  as  efficient  as  possi- 
ble within  this  guideline.  The  notes  often  describe  more  efficient  procedures. 

7)  Programs  use  consistent  memory  allocations.  Each  program  starts  in  memory  loca- 
tion 0000  (the  RESET  location)  and  ends  with  the  HALT  instruction.  If  your 


EXAMPLE 
FORMAT 


GUIDELINES 
FOR 

EXAMPLES 
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PROGRAMMING 
GUIDELINES 


microcomputer  has  no  monitor  and  no  Interrupts,  vou  may  prefer  to  end  programs 
with  an  endless  loop  instruction,  e.g.: 

HERE:      JR  HERE 

The  hexadecimal  version  is  18  followed  by  FE.  You  may  replace  the  HALT  or  JR 
HERE  instruction  with  a  RESTART  or  JP  instruction  that  transfers  control  back  to 
the  monitor  in  some  Z80-based  microcomputers. 

Consult  the  user's  manual  for  your  microcomputer  to  determine  the  required  memory 
allocations  and  terminating  instruction  for  your  particular  system. 

GUIDELINES  FOR  PROBLEMS 

When  tackling  the  problems  at  the  end  of  each  chapter,  try 
to  work  within  the  following  guidelines: 

1)  Comment  each  program  so  that  others  can  understand  it 
The  comments  can  be  brief  and  ungrammatical:  they 

should  explain  the  purpose  of  a  section  or  Instruction  in  the  program.  Comments 
should  not  describe  the  operation  of  instructions;  that  description  is  available  in 
manuals.  You  do  not  have  to  comment  each  statement  or  explain  the  obvious.  You 
may  follow  the  format  of  the  examples  but  provide  less  detail. 

2)  Emphasize  clarity,  simplicity,  and  good  structure  in  programs.  While  programs 
should  be  reasonably  efficient,  do  not  worry  about  saving  a  single  byte  of  program 
memory  or  a  few  microseconds. 

3)  Make  programs  reasonably  general.  Do  not  confuse  parameters  (such  as  the  num- 
ber of  elements  In  an  array)  with  fixed  constants  (such  as  tt  or  ASCII  C). 

4)  Never  assume  fixed  initial  values  for  parameters,  i.e.,  use  an  instruction  to  load  an 
initial  value  into  a  parameter. 

5)  Use  assembler  notation  as  shown  in  the  examples  and  defined  In  Chapter  3. 

6)  Use  hexadecimal  notation  for  addresses.  Use  the  clearest  possible  form  for  data. 

7S  If  your  microcomputer  allows  it,  start  all  programs  in  memory  location  0000  and 
use  memory  locations  starting  with  0040 .jg  for  data  and  temporan/  storage.  Other- 
wise, establish  equivalent  addresses  for  your  microcomputer  and  use  them  consis- 
tently. Again,  consult  the  user's  manual. 

8!  Use  meaningful  names  for  labels  and  variables,  e.g.,  SUM  or  CHECK  rather  than  X, 
Y,  or  Z. 

9)  Execute  each  program  on  your  microcomputer.  There  is  no  other  way  of  ensuring 
that  your  program  is  correct.  We  have  provided  sample  data  with  each  problem.  Be 
sure  that  the  program  works  for  special  cases. 

We  now  summarize  some  useful  information  that  you  should  keep  in  mind  when 
writing  programs. 


USING  THE 
ACCUMULATOR 


Almost  all  processing  instructions  (e.g..  ADD,  SUBTRACT, 
AND,  ORl  use  the  Accumulator.  In  most  cases  you  will  load 
data  Into  the  Accumulator  with  LP.  using  either  LD  A,(addr)  to 
load  data  from  any  memory  location  or  using  LD  A,(HL)  to  load 
data  from  the  address  specified  in  Registers  H  and  L.  Remember  that  the  parentheses 
indicate  a  memory  address  rather  than  data. 

The  preferred  method  of  accessing  memory  is  using  implied  ad- 
dressing via  Registers  H  and  L,  that  is,  using  (HL).  This  code  causes 
the  Z80  to  perform  a  memory  access  using  the  address  stored  in 
Registers  H  and  L.  You  can  use  LD  HL,  data16  to  load  a  fixed  num- 


USING 
REGISTER 
PAIR  HL 
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ber  into  Registers  H  and  L  or  LD  HL,(addrt  to  load  the  contents  of  two  successive  nnemo- 
rv  locations  into  H  and  L.  You  can  use  INC  HL  or  DEC  HL  to  incrennent  or  decrement  (bv 
1)  the  address  in  Registers  H  and  L. 

The  8-bit  arithmetic  and  logical  operations  all  use  the  data  in  the  Accumulator  as  one  of 
their  operands  and  place  their  result  into  the  Accumulator.   

Some  of  the  8-bit  arithmetic  and  logical  operations  have  special  SPECIAL 

uses,  for  example:  INSTRUCTIONS 


SUB  A  (or  XOR  A)  clears  the  Accumulator. 

ADD  A,A  shifts  the  Accumulator  left  one  bit  logicallv.  This  instruction  also  multiplies 
the  contents  of  the  Accumulator  bv  2.  AND  A  (or  OR  A)  clears  the  Carr/  flag  while 
preserving  the  contents  of  the  Accumulator. 

A  logical  AND  can  mask  off  parts  of  a  word.  The  required  mask  has  '1'  bits  in  the  posi- 
tions that  you  want  to  reserve  and  '0'  bits  in  the  positions  that  vou  want  to  clear. 

PROGRAM  EXAMPLES 

Ones  Complement 

Purpose:  Logically  complement  the  contents  of  memory  location  0040  and  place  the 
result  into  memory  location  0041. 

Sample  Problem: 

(0040)  =  6A 

(0041)  =  95 


Result: 

Source  Program: 

LD 

CPL 

LD 

HALT 


A,(40H) 
(41H),A 


GET  DATA 
COMPLEMENT 
STORE  RESULT 


Object  Program: 

Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

3A 

LD 

A,(40H) 

0001 

40 

0002 

00 

0003 

2F 

CPL 

0004 

32 

LD 

(41H),A 

0005 

41 

0006 

00 

0007 

76 

HALT 

The  LD  A,(addr)  and  LD  (addri.A  instructions  contain  addresses  to  determine  the  source 
or  destination  of  the  data.  The  addresses  are  16  bits  long,  with  the  eight  least  signifi- 
cant bits  in  the  word  immediately  following  the  instruction  code  and  the  eight  most  sig- 
nificant bits  in  the  next  word  (this  order  is  contrary  to  normal  computer  practice).  CPL  is 
a  one-word  instruction  that  inverts  each  bit  of  the  Accumulator.  It  replaces  each  '0' 
with  a  '1'  and  each  '1'  with  a  '0',  just  like  a  set  of  inverter  gates. 

HALT  IS  used  to  end  all  the  examples. 

Note  that  we  could  also  place  an  address  into  Registers  H  and  L  and  then  use  that  ad- 
dress throughout  the  program.  This  is  shown  in  the  following  program. 
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Source  Program: 


LD 

HL,40H 

:POINT  TO  OPERAND 

LD 

A,(HU 

:GET  DATA 

CPL 

-.COMPLEMENT 

INC 

HL 

;  POINT  TO  DESTINATION 

LD 

iHU.A 

;STORE  RESULT 

HALT 

Object  Program: 

Memory  Address      Memory  Contents  Instruction 
  (Hex)  (Hex)  (Mnemonic) 

21  LD  HL,40H 
40 
00 

7E  LD  A,(HL) 

2F  CPL 

23  INC  HL 

77  LD  (HU.A 

76  HALT 


Which  version  do  you  think  Is  better? 

The  two  versions  require  the  same  number  of  bytes  of  memory  even  though  the  second 
version  is  two  instructions  longer.  This  is  because  the  second  version  uses  fewer  ex- 
plicit addresses. 

8-Bit  Addition 

Purpose:  Add  the  contents  of  memory  locations  0040  and  0041,  and  place  the  result 
into  memory  location  0042. 

Sample  Problem: 

(0040)  =  38 

(0041)  =  2B 

Result:   (0042)   =  63 
Source  Program : 


LD 

A,(40H) 

;GET  FIRST  OPERAND 

LD 

B.A 

:SAVE  FIRST  OPERAND 

LD 

A,(41H) 

;GET  SECOND  OPERAND 

ADD 

A.B 

;ADD  OPERANDS 

LD 

(42H),A 

;  STORE  SUM 

HALT 

0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

3A 

LD 

.A,(40H) 

0001 

40 

0002 

00 

0003 

47 

LD 

B.A 

0004 

3A 

LD 

A,{41H) 

0005 

41 

0006 

40 

0007 

80 

ADD 

A.B 

0008 

32 

LD 

(42H),A 

0009 

42 

OOOA 

00 

OOOB 

76 

HALT 

Here  again,  we  could  alternatively  use  Registers  H  and  L  as  the  source  for  all  addresses. 

Source  Program: 

LD  HL.40H 

LD  .A,(HL) 

:GET  FIRST  OPERAND 

INC  HL 

ADD  A,(HL) 

;ADD  SECOND  OPERAND 

INC  HL 

LD  !HU,A 

iSTORE  RESULT 

HALT 

Object  Program : 

Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

7E 

LD 

A,(HL) 

0004 

23 

INC 

HL 

0005 

86 

ADD 

A.(HL) 

0006 

23 

INC 

HL 

0007 

77 

LD 

(HU.A 

0008 

76 

HALT 

In  this  case,  the  program  using  Registers  H  and  L  is  shorter  than  the  one  using  direct 
addressing.  Why? 


LD  HL,40H  loads  the  contents  of  the  following  two  words  of  program  memory  into 
Register  Pair  HL.  The  first  word  goes  into  Register  L,  the  second  into  Register  H. 

The  code  (HL)  means  that  data  is  obtained  from  or  sent  to  the  memory  location  ad- 
dressed by  Registers  H  and  L.  Thus.  LD  A,(HL)  loads  the  Accumulator  with  the  contents 
of  the  addressed  memory  location:  LD  {HL),A  loads  the  addressed  memory  location  with 
the  contents  of  the  Accumulator.  .ADD  A,(HL)  adds  the  contents  of  the  location  ad- 
dressed by  HL  to  the  contents  of  the  Accumulator.  Remember  that  H  and  L  contain  a 
16-bit  address,  but  the  memory  location  with  that  address  contains  eight  bits  of  data. 
Note  the  difference  between  ADD  A,(HL)  and  ADD  A,H  or  ADD  A.L. 

INC  HL  performs  a  16-blt  increment  in  one  instruction  cycle.  The  CPU  doesn't  use  the 
8-bit  arithmetic  unit  for  the  increment;  it  uses  the  incrementer  that  it  normally  uses  to 
increment  the  16-bit  Program  Counter. 
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LD  A,(HU  and  LD  (HLi.A  are  preferable  to  LD  A.laddr)  and  LD  (addri.A  whenever  you 
use  the  same  memorv  location  repeatedly  or  use  adjacent  locations,  because  LD  A,(HL) 
and  LD  (HL).A  require  less  program  memorv  and  time.  Note,  howeyer.  that  you  must 
load  Registers  H  and  L  before  you  can  use  (HL). 

Shift  Left  One  Bit 

Purpose:  Shift  the  contents  of  memory  location  0040  left  one  bit  and  place  the  result 
into  memory  location  0041.  Clear  the  empty  bit  position.  This  type  of  shift  is 
known  as  a  logical  shift.  In  a  logical  shift,  a  yalue  of  zero  is  always  shifted  in. 

Sample  Problem: 

(0040)   =  6F 

Result:   (0041)   =  DE 

Source  Program: 

LD  A,(40H) 

ADD  A.A 

LD  (41H).A 
HALT 


GET  DATA 
SHIFT  LEFT 
STORE  RESULT 


Object  Program: 

Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

3A 

LD 

A,(40H) 

0001 

40 

0002 

00 

0003 

87 

.ADD 

A.A 

0004 

32 

LD 

0005 

41 

{41H),A  j 

0006 

00 

1  0007 

76 

HALT 

ADD  A.A  simply  adds  the  contents  of  the  Accumulator  to  itself.  The  result,  of  course,  is 
twice  the  original  data,  which  is  the  same  result  that  a  logical  left  shift  would  produce. 
The  least  significant  bit  of  the  result  is  zero,  since  0+0  =  1+1  =0;  1+1  also  produces  a 
Carry  to  the  next  bit. 

Alternatiyelv.  we  could  replace  ADD  A.A  with  SLA  A.  certainly  the  more  obvious 
choice.  However.  SLA  A  requires  two  words  of  program  memory  and  eight  clock  cycles, 
while  ADD  A,A  requires  one  word  of  program  memory  and  four  clock  cycles.  The 
difference  is  caused  by  the  fact  that  SLA  A  is  one  of  the  extra  instructions  added  to  the 
original  8080A  set  (remember  the  companson  presented  earlier). 

Mask  Off  Most  Significant  Four  Bits 

Purpose:  Place  the  least  significant  four  bits  of  memory  location  0040  into  the  least 
significant  four  bits  of  memory  location  0041.  Clear  the  most  significant  four 
bits  of  memory  location  0041. 

Sample  Problem: 

(0040)   =  3D 
Result;   (0041)   =  OD 
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Source  Program: 

LD  A.(40H)  :GET  DATA 

AND  00001 11  IB  :MASK4LSB'S 
LD  (41H),A  :STORE  RESULT 

HALT 

Note:  B  means  binary  in  standard  Z80  assembler  notation. 


Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

3A 

LD 

A.(40H> 

0001 

40 

0002 

00 

0003 

Ee 

AND 

00001 11  IB 

0004 

OF 

0005 

32 

LD 

(41 H),  A 

0006 

41 

0007 

00 

0008 

76 

HALT 

The  mask  (00001 1 1 1)  is  written  in  binary  to  make  its  function  clearer  to  the  reader.  Bin- 
ary notation  for  masks  is  generally  much  clearer  than  hexadecimal  notation,  although 
the  results  are  the  same.  Hexadecimal  notation  should  be  used  for  masks  longer  than 
four  bits.  The  comments  should  explain  the  masking  operation. 


When  the  argument  in  the  address  field  is  a  number.  AND  logically  ANDs  the  contents 
of  the  Accumulator  with  the  contents  of  the  word  of  program  memory  immediately 
following  the  instruction.  AND  may  be  used  to  clear  bits  that  are  not  in  use.  The  four 
least  significant  bits  could  be  an  input  from  a  switch  or  an  output  to  a  numeric  display. 

Clear  a  Memory  Location 

Purpose:  Clear  memory  location  0040. 
Source  Program : 

SUB  A 

LD  {40H),A        ;  CLEAR  LOCATION  40 

HALT 


Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

97 

SUB  A 

0001 

32 

LD  (40H),A 

0002 

40 

0003 

00 

0004 

76 

HALT 

SUB  A  subtracts  the  number  in  the  Accumulator  from  itself.  The  result  is  to  clear  the 
Accumulator.  SUB  A.  XOR  A.  or  LD  A.O  can  all  clear  the  Accumulator.  LD  A,0  takes 
more  time  and  memory  but  doesn't  affect  the  status  flags. 


Word  Disassembly 

Purpose:  Divide  the  contents  of  memory  location  0040  into  two  4-bit  sections  and 
store  them  in  memory  locations  0041  and  0042.  Place  the  four  most  signifi- 
cant bits  of  memory  location  0040  into  the  four  least  significant  bit  positions 
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of  memorv  location  0041 ;  place  the  four  least  significant  bits  of  memorv 
location  0040  Into  the  four  least  significant  bit  positions  of  memorv  location 
0042.  Clear  the  four  most  significant  bit  positions  of  memory  locations  0041 
and  0042. 

Sample  Problem: 

(0040)   =  3F 

Result;   (0041)   =  03 
(0042)   =  OF 

Source  Program: 


LD 

HL,40H 

LD 

A,(HU 

:GET  DATA 

LD 

B.A 

RRA 

;SHIFT  DATA  RIGHT  4  TIMES 

RRA 

RRA 

RRA 

AND 

00001 11  IB 

:MASK  OFF  MSB'S 

INC 

HL 

LD 

(HL),A 

; STORE  MSB'S 

LD 

A.B 

.•RESTORE  ORIGINAL  DATA 

AND 

00001 11  IB 

:MASK  OFF  LSB'S 

INC 

HL 

LD 

(HU.A 

:STORE  LSB'S 

HALT 

Object  Program: 


Memorv  Address 

Memorv  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

7E 

LD 

A,(HL) 

0004 

47 

LD 

B.A 

OOOB 

IF 

RRA 

0006 

IF 

RRA 

0007 

IF 

RRA 

0008 

IF 

RRA 

0009 

E6 

AND 

00001 11  IB 

OOOA 

OF 

OOOB 

23 

INC 

HL 

OOOC 

77 

LD 

(HU.A 

OOOD 

78 

LD 

A.B 

OOOE 

E6 

AND 

00001 11  IB 

OOOF 

OF 

0010 

23 

INC 

HL 

0011 

77 

LD 

(HU.A 

0012 

76 

HALT 

Instructions  using  the  address  in  Registers  H  and  L  occupy  only  one  word  of  program 
memorv-  However.  HL  must  be  loaded  before  the  address  can  be  used.  Thus,  implied 
memory  addressing  saves  time  and  memory,  as  compared  to  direct  memory  addressing, 
only  when  the  program  repeatedly  uses  the  same  address  or  consecutive  addresses. 
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RRC  shifts  the  Accumulator  right  one  bit  circular,  with  the  least  significant  bit  going  to 
the  most  significant  bit  position  and  to  the  Carry.  Shifting  the  Accumulator  right  four 
times  requires  four  RRCs.  We  could  use  SRL  A  to  provide  a  logical  shift  directly  (no  final 
AND  would  then  be  necessary).  However,  SRL  A  requires  twice  as  much  time  and 
memory  as  RRC.  Try  substituting  SRL  A  for  RRC  and  see  the  difference.  Another  alter- 
native would  be  to  use  the  RLD  instruction  to  replace  both  the  mask  and  the  store. 
However,  this  solution  is  not  optimal  in  terms  of  either  storage  or  execution  speed  due 
to  the  constraint  that  the  high-order  nibble  of  each  result  must  equal  zero. 

Many  Z80  instructions  affect  a  pair  of  8-bit  registers.  The  pairs  are  HL  (H  and  L),  DE  (D 
and  E),  and  BC  (B  and  C).  Registers  B,  D.  and  H  are  the  most  significant  eight  bits  of  the 
pairs:  Registers  C,  E,  and  L  are  the  least  significant  eight  bits.  The  common  instructions 
that  use  pairs  of  registers  are  LD  rp  (Load  Register  Pair),  INC  rp  (Increment  Register 
Pair),  DEC  rp  (Decrement  Register  Pair),  and  ADD  HL,rp  (Add  Register  Pair  to  H  and  L). 

Find  Larger  of  Two  Numbers 

Purpose:  Place  the  larger  of  the  contents  of  memory  locations  0040  and  0041  into 
memory  location  0042.  Assume  that  the  contents  of  memory  locations  0040 
and  0041  are  unsigned  binary  numbers. 

Sample  Problems: 

a.  (0040)   =  3F 
(0041)   =  28 

Result:   (0042)   =  3F 

b.  (0040)   =  75 
(0041)   =  A8 

Result:    (0042)   =  A8 

Source  Program: 


LD 

HL,40H 

LD 

A,(HL) 

:GET  FIRST  OPERAND 

INC 

HL 

CP 

(HL) 

:IS  SECOND  OPERAND  LARGER? 

JR 

CDONE 

LD 

A,(HU 

;YES,  GET  SECOND  OPERAND  INSTEAD 

INC 

HL 

LD 

(HL),A 

:STORE  LARGER  OPERAND 

HALT 

Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

7E 

LD 

A,(HL) 

0004 

23 

INC 

HL 

0005. 

BE 

CP 

(HL) 

0006 

30 

JR 

NCDONE 

0007 

01 

0008 

7E 

LD 

A,(HU 

0009 

23  DONE: 

INC 

HL 

OOOA 

77 

LD 

(HL),A 

0008 

76 

HALT 
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CP  (HU  sets  the  flags  as  if  the  contents  of  the  memory  location  addressed  by  H  and  L 
had  been  subtracted  from  the  contents  of  the  Accumulator.  However,  the  contents  of 
the  Accumulator  are  left  unchanged  for  later  comparisons  or  other  processing. 

If  A  is  the  contents  of  the  Accumulator  and  X  is  the  second  operand  for  a  CP  instruc- 
tion, then  the  flags  are  set  as  follows: 

1)  Zero=1  if  A=  X 
Zero  =  0  if  A  X 

2)  Carn/  =  1  if  A  <  X 
Carp/  =  0  if  A  >  X 

(A,  X  are  unsigned  binary  numbers) 

CP  sets  the  Carry  to  1  if  a  borrow  would  be  necessary  to  actually  perform  the  subtrac- 
tion, i.e.,  if  the  number  being  subtracted  from  the  contents  of  the  Accumulator  is 
greater  than  those  contents.  Thus,  the  sequence  CP,  JR  NC.DONE  causes  a  jump  to 
DONE  if  the  contents  of  the  Accumulator  are  greater  than  or  equal  to  the  other  number. 

JR  NCDONE  causes  a  jump  to  memory  location  DONE  if  the  Carry  flag  =  0.  Othero/ise 
(if  Carp/  =  1),  the  computer  continues  with  the  next  sequential  memory  location  after 
the  JR  instruction. 

DONE  is  a  label,  a  name  which  you  assign  to  a  location  in  memory  so  that  it  is  easier  to 
remember.  Note  that  labels  are  followed  by  a  colon  on  the  line  where  they  are  defined. 

The  label  makes  the  destination  of  the  branch  clearer,  particularly  when  relative  ad- 
dressing is  being  used.  The  assembler  calculates  the  required  offset  (caution;  some  Z80 
assemblers  will  not  do  this).  Using  a  label  is  preferable  to  just  specifying  the  offset  (i.e., 
JR  NC,$-(-3)  since  the  Z80's  instructions  vary  in  length.  You  could  therefore  easily  make 
an  error  in  determining  an  offset. 

If  the  branch  conditions  are  not  satisfied,  the  processor  simply  proceeds  to  the  next  se- 
quential location  in  program  memory  (i.e.,  it  executes  the  instruction  LD  A,{HL)). 

The  Z80  assemblers  allow  six  characters  in  labels  —  the  first  must  be  a  letter,  while  the 
others  may  be  letters  or  numbers  (some  special  characters  are  allowed  but  we  will  not 
use  them). 

The  JR  instruction  uses  relative  addressing  in  which  the  second  word  of  the  instruction 
is  an  8-bit  twos  complement  number  that  the  CPU  adds  to  the  address  of  the  next  in- 
struction to  find  the  target  address.  In  the  example,  the  relative  offset  is  0009  (target 
address)  minus  0008  (address  immediately  following  the  branch)  or  01. 

We  should  note  that  some  Z80  assemblers  will  not  calculate  the  offset  in  the  form 
shown.  These  assemblers  require  an  offset  in  the  address  field,  rather  than  the  label  of 
the  target  instruction.  If  you  have  such  an  assembler,  use  the  form  JR  NC,DONE-$. 
Remember  that  $  means  "the  address  of  the  current  instruction" 

The  Z80  has  two  sets  of  jump  instructions,  JP  (Jump)  and  JR  (Jump  Relative).  The  JP 
instructions  require  a  complete  memon/  address;  thev  occupy  three  bytes  of  memory 
and  execute  in  ten  clock  cycles.  The  JR  instructions  require  only  a  one-word  offset; 
they  occupy  two  bytes  of  memory  and  execute  in  12  cycles  if  a  jump  is  actually  per- 
formed and  in  7  if  not.  So  the  JR  instructions  use  less  memory  than  JP  instructions  but 
may  require  a  little  extra  time  if  a  jump  is  performed  (the  extra  time  is  used  to  execute 
the  required  16-bit  addition  of  program  counter  and  offset). 
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16-Bit  Addition 

Purpose:  Add  the  16-bit  number  in  memory  locations  0040  and  0041  to  the  lO-bit 
number  in  memory  locations  0042  and  0043.  The  most  significant  eight  bits 
are  in  memory  locations  0041  and  0043.  Store  the  result  in  memory  loca- 
tions 0044  and  0045,  with  the  most  significant  bits  in  0045. 

Sample  Problem: 

(0040)  =  2A 

(0041)  =  67 

(0042)  =  F8 

(0043)  =  14 

Result;  672A  -I-  14F8  =  7C22 

(0044)  =  22 

(0045)  =  7C 

Source  Program : 

LD  HL,(40H) 

LD  DE,(42H) 

ADD  HLDE 

LD  (44H),HL 
HALT 


Object  Program : 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

2A 

LD 

HL,(40H) 

0001 

40 

0002 

00 

0003 

ED 

LD  • 

DE,(42H) 

0004 

5B 

0005 

42 

0006 

00 

0007 

19 

ADD 

HL.DE 

0008 

22 

LD 

(44H),HL 

0009 

44 

OOOA 

00 

OOOB 

76 

HALT 

LD  HL,(addr)  loads  Registers  H  and  L  from  two  memory  locations,  the  one  specified  in 
the  instruction  and  the  next  consecutive  one.  The  contents  of  the  first  addressed  loca- 
tion go  to  Register  L.  The  contents  of  the  next  location  go  to  Register  H.  Thus,  LD 
HL,(40H)  means  L  =  (40),  H  =  (41).  The  actual  transfer  proceeds  one  byte  at  a  time  and 
takes  16  clock  cycles.  The  advantage  of  the  16-bit  Load  instruction  over  two  8-bit  Load 
instructions  is  that  the  CPU  has  to  fetch  only  one  instruction  from  memory. 

Note  the  difference  between  LD  HL.(addr),  which  loads  the  contents  of  the  two  RAM 
locations  at  addr  and  addr-H  into  H  and  L,  and  LD  HL,data16,  which  loads  the  contents 
of  the  next  two  bytes  pointed  to  by  the  instruction  counter  into  H  and  L.  Since  these 
two  bytes  immediately  follow  the  op-code,  loads  of  this  type  are  referred  to  as  load  im- 
mediate instructions. 

LD  DE,(addr)  is  similar  to  LD  HL,(addr)  except  that  it  takes  one  extra  word  of  memory 
and  four  more  clock  cycles.  This  is  one  of  the  instructions  that  is  present  in  the  ZBO  set 
but  not  in  the  8080/8085  sets.  An  alternative  approach  is: 

EX  DE,HL  :SAVE  FIRST  16-BIT  NUMBER  IN  DE 

LD  HL,(42H)       :GET  SECOND  1 6-BIT  NUMBER 


;GET  FIRST  ie-BIT  NUMBER 
:GET  SECOND  16-BIT  NUMBER 
;  16-BIT  ADDITION 
;STORE  16-BIT  RESULT 
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EX  DE.HL  exchanges  the  contents  of  Registers  D  and  E  with  H  and  L  No  numbers  are 
changed  or  destroyed.  The  advantage  of  EX  DE.HL  will  become  obvious  if  you  try  to 
replace  it  with  a  series  of  LD  instructions. 

-ADD  HL.DE  adds  the  16-bit  number  in  Registers  D  and  E  to  the  16-bit  number  in 
Registers  H  and  L.  The  result  is  placed  into  Registers  H  and  L.  ADD  HL.DE  actually  adds 
one  byte  at  a  time.  It  executes  in  1 1  clock  cycles. 

LD  (addrl.HL  stores  the  contents  of  Registers  H  and  L  into  two  memory  locations,  the 
one  specified  in  the  instruction  and  the  next  consecutive  one.  The  contents  of  L  go  into 
the  specified  location  and  the  contents  of  H  go  into  the  next  location.  Thus,  LD  (44H),HL 
means  !44)  =  L,  (45)  =  H.  As  with  LD  HL,(addri,  the  actual  transfer  proceeds  one  byte  at 
a  time  and  requires  16  clock  cycles. 

Although  theZSO  is  an  8-bit  processor,  it  has  instructions  that  handle  16-bit  numbers. 
These  instructions  are  intended  primarily  for  handling  addresses,  but  you  can  also  use 
them  for  16-bit  data.  The  most  common  ones  and  their  uses  are: 

11    ADD  HL.rp  — 16-Bit  Add 

Used  to  access  tables  and  to  add  16-bit  data  units 

2)  DEC  rp  —  1 6-Bit  Decrement 

Used  to  subtract  one  from  the  contents  of  a  register  pair 

3)  INC  rp  —  1 6-Bit  Increment 

Used  to  add  one  to  the  contents  of  a  register  pair 

4)  LD  rp.datal 6  — 16-Bit  Load  Immediate 

Used  to  initialize  a  register  pair  with  a  fixed  value,  e.g.,  the  starting  address  of  an  ar- 
ray or  table 

6)    LD  HL,(addrl  —  16-Bit  Load  HL  Direct 

Used  to  place  variable  addresses  into  the  mam  address  register  (H  and  L) 

6)    LD  (addrl.HL  —  1 6-Bit  Store  HL  Direct 

Used  to  store  addresses  to  memory  from  the  mam  address  register  (H  and  L). 

Table  of  Squares 

Purpose:  Calculate  the  square  of  the  contents  of  memory  location  0040  from  a  table 
and  place  it  into  memory  location  0041.  Assume  that  memory  location  0040 
contains  a  number  between  0  and  7  inclusive  (0  <  (0041)  <  7). 


The  table  occupies  memory  locations  0050  to  0057 


Memory  Address 
(Hex) 

Entry 

(Hex) 

(Decimal) 

0050 

00 

0 

0051 

01 

1 

(12) 

0052 

04 

4 

i2i) 

0053 

09 

9 

0054 

10 

16 

(4t) 

0055 

19 

25 

(5^) 

0056 

24 

36 

(6^1 

0057 

31 

49 

(7^) 

Sample  Problems: 

a.  (0041)  =  03 
Result:   (0042)  =  09 

b.  (0041)  =  06 
Result:   (0042)  =  24 
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Source  Program: 


LD 

A.{40H) 

:GET  DATA 

LD 

L.A 

:MAKE  DATA  INTO  16-BIT  INDEX 

LD 

n,u 

LD 

DE.SuTAB 

;GET  STARTING  ADDRESS  OF  TABLE 

ADD 

HL.DE 

;INDEX  TABLE  WITH  DATA 

LD 

A,(HL) 

:GET  SQUARE  OF  DATA 

LD 

(41H).A 

HALT 

ORG 

BOH 

;SaUARE  TABLE 

SQTAB:  DEFB 

0 

DEFB 

1 

DEFB 

4 

DEFB 

9 

DEFB 

16 

DEFB 

25 

DEFB 

36 

DEFB 

49 

Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

SHex) 

(Hex) 

(Mnemonic) 

GOOD 

3A 

LD 

A,(40H) 

0001 

40 

0002 

00 

0003 

6F 

LD 

L.A 

0004 

26 

LD 

H.O 

0005 

00 

0006 

11 

LD 

DE.SQTAB 

0007 

50 

0008 

00 

0009 

19 

ADD 

HLDE 

OOOA 

7E 

LD 

A,(HL) 

OOOB 

32 

LD 

(41 H),  A 

OOOC 

41 

OOOD 

00 

OOOE 

76 

0050 

00 

SQTAB  ■.  DEFB 

0 

0051 

01 

DEFB 

1 

0052 

04 

DEFB 

4 

0053 

09 

DEFB 

9 

0054 

10 

DEFB 

16 

0055 

19 

DEFB 

25 

0056 

24 

DEFB 

36 

0057 

31 

DEFB 

49 

Note  that  you  must  also  enter  the  table  of  squares  into  memory  (the  assembler  pseudo- 
operation  DEFB  will  handle  this).  The  table  of  squares  is  constant  data,  not  parameters 
that  may  change;  that  is  why  you  can  initialize  the  table  using  the  DEFB  pseudo-opera- 
tion, rather  than  by  executing  instructions  to  load  values  into  the  table.  Remember  that 
the  table  is  part  of  the  program  memory  (ROM  in  most  systems). 


LD  L.A  moyes  the  data  in  the  .Accumulator  to  Register  L.  The  data  is  the  eight  least  sig- 
nificant bits  of  the  index.  You  cannot  always  assume  that  the  data  presented  to  your 
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program  is  in  the  proper  range.  It  is  always  a  good  practice  to  range  check  all  critical 
values.  Range  checking  consists  of  testing  a  value  to  ensure  that  it  is  within  the  proper 
lower  and  upper  limits.  Anv  byte  can  have  a  value  in  the  range  0  to  255.  If  the  value 
stored  in  the  byte  at  location  0040H  is  greater  than  seven,  the  program  will  reference 
an  undefined  byte  beyond  the  end  of  the  square  table,  causing  the  program  to  generate 
erroneous  results  Range  checking  will  prevent  this  error  from  occurring. 

LD  H,0  clears  Register  H  so  that  it  does  not  interfere  with  the  16-bit  addition  of  starting 
address  and  index.  Never  assume  that  a  register  contains  zero  at  the  start  of  a  program. 

LD  DE,SQTAB  loads  the  starting  address  of  the  table  into  Registers  D  and  E.  We  use  D 
and  E  for  the  starting  address  since  the  ADD  HL  instruction  does  not  change  D  and  E. 
Thus,  the  starting  address  of  the  table  will  still  be  In  D  and  E  after  the  addition,  in  the 
event  that  we  want  another  element  from  the  table. 

-ADD  HLDE  adds  the  starting  address  and  the  index;  the  result  in  H  and  L  is  thus  the  ad- 
dress of  the  correct  entry.  LD  A,(HL)  then  moves  that  entry  to  the  Accumulator, 

Arithmetic  that  a  microprocessor  cannot  do  directly  in  a  few  instructions  is  often  best 
performed  with  lookup  tables.  Lookup  tables  simply  contain  all  the  possible  answers  to 
the  problem;  they  are  organized  so  that  the  answer  to  a  particular  problem  can  be 
found  easily.  The  arithmetic  problem  now  becomes  an  accessing  problem  —  how  do 
we  get  the  correct  answer  from  the  table?  We  must  know  two  things:  the  position  of 
the  answer  in  the  table  (called  the  index)  and  the  base,  or  starting,  address  of  the  table. 
The  address  of  the  answer  is  then  the  base  address  plus  the  index. 

The  base  address,  of  course,  is  a  fixed  number  for  a  particular  table.  How  can  we  deter- 
mine the  index?  In  simple  cases,  where  a  single  piece  of  data  is  involved,  we  can  organ- 
ize the  table  so  that  the  data  is  the  index.  In  the  table  of  squares,  the  0th  entry  in  the  ta- 
ble contains  zero  squared,  the  first  entry  one  squared,  etc.  In  more  complex  cases, 
where  the  spread  of  input  values  is  very  large  or  there  are  several  data  items  involved 
(e.g.,  roots  of  a  quadratic  or  number  of  permutations!,  we  must  use  more  complicated 
methods  to  determine  indexes. 

The  basic  tradeoff  in  using  a  table  is  time  vs.  memory.  Tables  are  faster,  since  no  com- 
putations are  required,  and  simpler,  since  no  mathematical  methods  must  be  devised 
and  tested.  However,  tables  can  occupy  a  large  amount  of  memory  if  the  range  of  the 
input  data  is  large.  We  can  often  reduce  the  size  of  a  table  by  limiting  the  accuracy  of 
the  results,  scaling  the  input  data,  or  organizing  the  table  cleverly.  Tables  are  often 
used  to  compute  transcendental  and  trigonometric  functions,  linearize  inputs,  convert 
codes,  and  perform  other  mathematical  tasks. 

1 6-Bit  Ones  Complement 

Purpose:  Place  the  ones  complement  of  the  16-bit  number  in  memory  locations  0040 
and  0041  into  memory  locations  0042  and  0043.  The  most  significant  bytes 
are  in  locations  0041  and  0043. 

Sample  Problem: 

(0040)  =  67 

(0041)  =  E2 

Result:   (0042)   =  98 
(0043)   =  ID 

The  ones  complement  inverts  each  bit  of  the  original  number;  the  sum  of  the  original 
number  and  its  ones  complement  will  always  be  all  1  bits. 
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Source  Program : 


1  n 
LU 

Ui  MAUi 

nL,\4UnJ 

.be  1  UA  1 A 

A  i 

A.L 

.CUivlrLblvicN  1  o  Loo  o 

CPL 

LD 

LA 

LD 

A,H 

:COMPLEMENT  8  MSB'S 

CPL 

LD 

H,A 

LD 

(40H),HL 

:STORE  ONES  COMPLEMENT 

HALT 

Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

2A 

LD 

HL,(40H) 

0001 

40 

0002 

00 

0003 

7D 

LD 

A.L 

0004 

2F 

CPL 

0005 

6F 

LD 

L.A 

0006 

7C 

LD 

A.H 

0007 

2F 

CPL 

0008 

67 

LD 

H.A 

0009 

22 

LD 

(42H).HL 

OOOA 

42 

OOOB 

00 

OOOC 

76 

HALT 

Despite  the  Z80's  1 6-bit  instructions,  you  must  use  8-bit  instructions  to  perform  most 
arithmetic  and  logical  operations.  The  16-bit  instructions  can,  however,  be  used  to  load 
and  store  data  and  occasionally  to  do  a  few  16-bit  arithmetic  operations,  such  as  addi- 
tion, subtraction,  incrementing,  and  decrementing.  You  will  soon  learn  that  the  16-bit 
instructions  are  far  from  a  complete  set  and  you  may  often  run  into  awkward  problems 
if  using  them  to  manipulate  16-bit  data. 

PROBLEMS 

1)  Twos  Complement 

Purpose:  Place  the  twos  complement  of  the  contents  of  memory  location  0040  into 
memory  location  0041.  The  twos  complement  is  the  ones  complement  plus 
one. 

Sample  Problem: 

(0040)   =  3E 
Result:   (0041)   =  C2 
The  sum  of  the  original  number  and  its  twos  complement  is  zero  (try  the  sample  case). 

2)  8-Bit  Subtraction 

Purpose:  Subtract  the  contents  of  memory  location  0041  from  the  contents  of  memory 
location  0040.  Place  the  result  into  memory  location  0042. 

Sample  Problem: 

(0040)  =  77 

(0041)  =  39 

Result:   (0042)   =  3E 
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3)  Shift  Left  Two  Bits 

Purpose:  Shift  the  contents  of  memorv  location  0040  left  two  bits  and  place  the  result 
into  memory  location  0041.  Clear  the  two  least  significant  bit  positions. 

Sample  Problem: 

(0040!   =  5D 
Result:   (0041)   =  74 

4)  Mask  Off  Least  Significant  Four  Bits 

Purpose:  Place  the  four  most  significant  bits  of  the  contents  of  memorv  location  0040 
into  memory  location  0041.  Clear  the  four  least  significant  bits  of  memory 
location  0041. 

Sample  Problem: 

(0040)  =  C4 
Result:   (0041)   =  CO 

5)  Set  a  Memory  Location  to  All  Ones 

Purpose:  Memorv  location  0040  is  set  to  all  ones  (FF  hex). 

6)  Word  Assembly 

Purpose:  Combine  the  four  least  significant  bits  of  memory  locations  0040  and  0041 
into  a  word  and  store  them  in  memorv  location  0042.  Place  the  four  least  sig- 
nificant bits  of  memory  location  0040  into  the  four  most  significant  bit  posi- 
tions of  memory  location  0042;  place  the  four  least  significant  bits  of  memo- 
ry location  0041  into  the  four  least  significant  bit  positions  of  memory  loca- 
tion 0042. 

Sample  Problem: 

(0040!   =  6A 

(0041)  =  B3 

Result:   (0042)   =  A3 

7)  Find  Smaller  of  Two  Numbers 

Purpose:  Place  the  smaller  of  the  contents  of  memory  locations  0040  and  0041  into 
memory  location  0042.  Assume  that  0040  and  0041  contain  unsigned  bin- 
ary numbers. 

Sample  Problems: 


a. 

(0040) 

=  3F 

(0041) 

=  2B 

Result:  (0042) 

=  2B 

b. 

(0040) 

=  75 

(0041) 

=  A8 

Result:  (0042! 

=  75 

8) 

24-Bit  Addition 

Purpose:  Add  the  24-bit  number  in  memory  locations  0040,  0041,  and  0042  to  the  24- 
bit  number  in  memorv  locations  0043,  0044.  and  0045.  The  most  significant 
eight  bits  are  in  memory  locations  0042  and  0045;  the  least  significant  eight 
bits  are  in  memorv  locations  0040  and  0043.  Store  the  result  in  memorv 
locations  0046,  0047.  and  0048  with  the  most  significant  bits  in  0048  and 
the  least  significant  bits  in  0046. 
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Sample  Problem: 


!0040) 
!0041) 
(0042) 
(0043) 
(0044) 
(0045) 

Result:  (0046) 
(0047) 
(0048) 

that  is,  35672A 
+51A4F8 
870C22 

9)  Sum  of  Squares 

Purpose:  Calculate  the  squares  of  the  contents  of  memory  locations  0040  and  0041 
and  add  them  together.  Place  the  result  into  memory  location  0042.  Assume 
that  memory  locations  0040  and  0041  both  contain  numbers  between  0  and 
7  inclusive  (0  <,  (0040)  ^  7  and  0  ^  (0041)  ^  7).  Use  the  table  of  squares 
from  the  example  entitled  Table  of  Squares. 

Sample  Problem: 

(0040)  =  03 

(0041)  =  06 

Result:    (0042)  =  2D 

that  is,  32  +  62  =  9  +  36  =  45  (decimal) 
=  2D  (hex) 

10)  1 6-Bit  Twos  Complement 

Purpose:  Place  the  twos  complement  of  the  16-bit  number  in  memory  locations  0040 
and  0041  (most  significant  bits  in  0041)  into  memory  locations  0042  and 
0043  (most  significant  bits  in  0043). 


Sample  Problems: 


a. 

(0040) 
(0041) 

=  00 
=  58 

Result: 

(0042) 
(0043) 

=  00 
=  AS 

b. 

(0040) 
(0041) 

=  72 
=  00 

Result: 

(0042) 
(0043) 

=  BE 
=  FF 

=  2A 

=  67 

=  35 

=  F8 

=  .A4 

=  51 

=  22 

=  OC 

=  87 
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Chapter  5 
SIMPLE  PROGRAM  LOOPS 


The  program  loop  is  the  basic  structure  that  forces  the  CPU  to  repeat  a  sequence  of  in- 
structions. Loops  have  four  sections: 

1)  The  initialization  section,  which  establishes  the  starting  values  of  counters,  address 
registers  (pointers),  and  other  variables. 

2)  The  processing  section,  where  the  actual  data  manipulation  occurs.  This  is  the  sec- 
tion that  does  the  work. 

3)  The  loop  control  section,  which  updates  counters  and  pointers  for  the  next  itera- 
tion. 

4)  The  concluding  section,  which  analyzes  and  stores  the  results. 

Note  that  the  computer  performs  Sections  1  and  4  once,  while  it  mav  perform  Sections 
2  and  3  many  times.  Thus,  the  execution  time  of  the  loop  will  mainly  depend  on  the  ex- 
ecution time  of  Sections  2  and  3.  You  will  want  Sections  2  and  3  to  execute  as  quickly 
as  possible;  do  not  worry  about  the  execution  time  of  Sections  1  and  4.  A  typical  pro- 
gram loop  can  be  flowcharted  as  shown  in  Figure  5-1 ,  or  the  positions  of  the  processing 
and  loop  control  sections  may  be  reversed  as  shown  in  Figure  5-2.  The  processing  sec- 
tion in  Figure  5-1  is  always  executed  at  least  once,  while  the  processing  section  in 
Figure  5-2  may  not  be  executed  at  all.  Figure  5-1  seems  more  natural,  but  Figure  5-2  is 
often  more  efficient  and  avoids  the  problem  of  what  to  do  when  there  is  no  data  (a 
bugaboo  for  computers,  and  the  frequent  cause  of  silly  situations  like  the  computer 
dunning  someone  for  a  bill  of  $0.00). 

The  loop  structure  can  be  used  to  process  entire  blocks  of  data.  To  accomplish  this,  the 
program  must  increment  an  address  register  (usually  register  pair  HL)  after  each  itera- 
tion so  that  the  address  register  points  to  the  next  element  in  the  data  block.  The  next 
iteration  will  then  perform  the  same  operations  on  the  data  in  the  next  memory  loca- 
tion. The  computer  can  handle  blocks  of  any  length  with  the  same  set  of  instructions. 

Implied  addressing  through  register  pairs  (particularly  HL)  is  the  key  to  processing  a 
block  of  data  with  the  Z80,  since  it  allows  you  to  vary  the  actual  memory  address  by 
changing  the  contents  of  registers.  Indexed  addressing,  while  longer  and  slower  on  the 
Z80  than  implied  addressing,  may  be  handy  when  processing  more  than  one  block  of 
data.  Note  that  in  the  immediate  and  direct  addressing  modes,  the  addresses  that  are 
used  are  completely  determined  by  the  instruction  (and  thus  fixed  if  the  program 
memop/  is  read-only). 
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HZ 

Initialization 
Section 


31 

Processing 
Section 


i 


Concluding 
Section 


(  ) 
I  

Figure  5-1.  Flowchart  of  a  Program  Loop 
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Initialization 
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Conciuding 
Section 
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Figure  5-2.  A  Program  Loop  that  Allows  Zero  Iterations 


EXAMPLES 
Sum  of  Data 

Purpose:  Calculate  the  sum  of  a  series  of  numbers.  The  length  of 
the  series  is  in  memory  location  0041.  and  the  series 
begins  in  memory  location  0042.  Store  the  sum  in 
memory  location  0040.  Assume  that  the  sum  is  an  8-bit 
number  so  that  you  can  ignore  carries. 

Sample  Problem: 

03 
28 
55 
26 

(0042)  +  (0043)  +  (0044) 
=  28-1-55-1-26 

=  A3 

There  are  three  entries  in  the  sum,  since  (0041  )=03. 


8-BIT 

SUMMATION 


(0041) 
(0042) 
(0043) 
(0044) 

Result:  (0040) 
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Note:  (Pointer)  is  the  contents  of  the  memory  location  addressed  by  Pointer.  Remember 
that  on  the  Z80,  Pointer  is  a  16-bit  address,  while  (Pointer)  is  an  8-bit  byte  of 
data. 

Source  Program : 


SUMD: 


LD 

HL.41H 

LD 

B,{HL) 

■.COUNT  =  LENGTH  OF  SERIES 

SUB 

A 

:SUM  =ZERO 

INC 

HL 

ADD 

A,(HL) 

;SUIVI  =  SUM  -1-  DATA 

DEC 

B 

JR 

NZ.SUMD 

LD 

(40H),A 

:STORE  SUM 

HALT 
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Object  Program : 


ivicu  lUI  y  '^Uu  1  coo 

iVlCillUiy  '—UlilCfUo 

Instruction 

\nciA/ 

\ncA/ 

(Mnemonic) 

0000 

21 

LD 

HL,41  H 

0001 

41 

0002 

00 

0003 

46 

LD 

B,(HL) 

0004 

97 

SUB 

A 

0005 

23 

SUMD:  INC 

HL 

0006 

86 

ADD 

A,(HL) 

0007 

05 

DEC 

B 

0008 

20 

JR 

NZ.SUMD 

0009 

FB 

OOOA 

32 

LD 

(40H),A 

OOOB 

40 

OOOC 

00 

OOOD 

76 

HALT 

The  initialization  section  of  the  program  is  the  first  three  instructions  which  set  the  sum. 
counter,  and  data  pointer  to  their  starting  values. 

Note  that  vou  can  use  LD  to  transfer  data  between  memory  and  any  of  the  primary 
general  purpose  registers  (i.e..  A.  B.  C.  D,  E.  H,  L)  using  the  address  in  Registers  H  and  L. 
However,  the  only  transfers  allowed  using  direct  addressing  are  those  that  move  data  to 
or  from  the  Accumulator  (i.e..  LD  .A.(addr)  and  LD  (addri.A  —  there  is  no  instruction  LD 
E.(addr),  for  example). 

The  processing  section  of  the  program  is  the  single  instruction  ADD  A,(HL)  which  adds 
the  contents  of  the  memory  location  being  addressed  by  Registers  H  and  L  to  the  con- 
tents of  the  Accumulator,  and  stores  the  result  in  the  Accumulator.  This  instruction 
does  the  real  work  of  the  program. 

The  loop  control  section  of  the  program  consists  of  the  instructions  INC  HL  and  DEC  B. 
INC  HL  updates  the  pointer  so  that  the  next  iteration  adds  the  next  number  to  the  sum. 
DEC  B  decrements  the  counter  that  keeps  track  of  how  many  iterations  are  left. 

The  instruction  JR  NZ  causes  a  branch  if  the  Zero  flag  is  zero.  The  offset  is  a  twos  com- 
plement number,  and  the  count  begins  from  the  memory  location  immediately  follow- 
ing the  JR  instruction.  In  this  case,  the  required  jump  is  from  memory  location  OOOA  to 
memory  location  0005.  So  the  offset  is: 

0005  ^  05 
-OOOA  +F6 
FB 

If  the  Zero  flag  is  one,  the  CPU  executes  the  next  instruction  in  sequence  (i.e..  LD 
(40H),A).  Since  DEC  B  was  the  last  instruction  before  JR  to  affect  the  Zero  flag,  JR 
NZ,SUMD  causes  a  jump  to  SUMD  if  DEC  B  does  not  produce  a  zero  result,  i.e.. 

!SUMD  if  B  4^0 
PC+2  if  B  =  0 
(The  2  IS  caused  by  the  two-word  JR  instruction). 
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The  loop  control  sequence  DEC  followed  by  JR  NZ  is  so  common  that  the  Z80  has  a 
special  instruction  that  both  decrements  the  counter  and  performs  the  jump.  This  in- 
struction IS  DJNZ,  Decrement  and  Jump  on  Not  Zero,  which  decrements  Register  Band 
then  lumps  by  the  specified  relative  offset  if  the  remainder  is  not  zero.  So  we  could 
change  the  end  of  the  example  to: 


DJNZ  SUMO 
LD  (40H),A 
HALT 

Which  has  the  object  form: 

07  10  DJNZ  SUMD 

08  FC 

09  32  LD  (40H),A 
OA  40 

OB  00 

OC  76  HALT 


This  change  saves  one  byte  of  memory  and  three  clock  cycles.  Note,  however,  that  you 
must  use  Register  8  as  the  counter  since  this  is  the  register  that  DJNZ  decrements. 

Since  the  offset  in  Z80  relative  lumps  is  only  one  byte  long,  such  lumps  can  go  no 
further  than  127  locations  forward  or  128  locations  backward  (actually  129  fonward  or 
126  backward,  since  the  count  starts  at  the  end  of  the  2-word  instruction).  Longer 
tumps  must  use  the  JP  instructions. 

Most  computer  loops  count  down  rather  than  up  so  that  the  Zero  flag  can  serve  as  an 
exit  condition.  Remember  that  the  Zero  flag  is  1  if  the  result  was  zero  and  0  if  the  result 
was  not  zero.  Try  rewriting  the  program  so  that  it  counts  up  rather  than  down:  which 
method  is  more  efficient? 

The  order  of  instructions  is  often  very  important.  DEC  B  must  come  right  before  JR 
NZ.SUMD,  since  otherwise  the  Zero  result  set  by  DEC  B  could  be  changed  by  another 
instruction.  INC  HL  must  come  before  ADD  A,(HL)  or  else  the  first  number  added  to  the 
sum  will  be  the  contents  of  memory  location  0041  instead  of  the  contents  of  memory 
location  0042. 

1 6-Bit  Sum  of  Data 

Purpose:  Calculate  the  sum  of  a  series  of  numbers.  The  length  of  the  series  is  in 
memory  location  0042  and  the  series  itself  begins  in  memory  location  0043. 
Store  the  sum  in  memory  locations  0040  and  0041  (eight  least  significant 
bits  in  0040). 

Sample  Problem: 

(0042)  =  03 

(0043)  =  C8 

(0044)  =  FA 

(0045)  =  96 

Result:  C8  -F  FA  -f  96  =0258 

(0040)  =  58 

(0041)  =  02 
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Flowchart: 


Source  Program 

LD 
LD 
SUB 
LD 

DSUMD:  INC 
ADD 
JR 
INC 

CHCNT;  DJNZ 
LD 
LD 
INC 
LD 

HALT 


HL,42H 

B,  (HL)  :COUNT  =  LENGTH  OF  SERIES 
A  :LSB'S  OF  SUM  =0 

C,  A  ;MSB'S  OF  SUM  =0 
HL 

A.iHL)  ;SUM  =  SUM  +  DATA 

NCCHCNT 

C  :ADD  CARRY  TO  MSB'S  OF  SUM 

DSUMD 

HL.40H 

(HU,A  ;STORE  LSB'S  OF  SUM 

HL 

(HL),C  :STORE  MSB'S  OF  SUM 
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Object  Program: 


Memory  Address      Memory  Contents  Instruction 
(Hex)  (Hex)  (Mnemonic) 


0000 

21 

LD 

HL.42H 

0001 

42 

0002 

00 

0003 

46 

LD 

B,(HL) 

0004 

97 

SUB 

A 

0005 

4F 

LD 

C.A 

0006 

23 

DSUMD: 

INC 

HL 

0007 

86 

ADD 

A,(HL) 

0008 

30 

JR 

NC. CHCNT 

0009 

01 

UUUA 

nn 
UO 

thin 

OOOB 

10 

CHCNT; 

DJNZ 

DSUMD 

OOOC 

F9 

OOOD 

21 

LD 

HL.40H 

OOOE 

40 

OOOF 

00 

0010 

77 

LD 

(HL),A 

0011 

23 

INC 

HL 

0012 

71 

LD 

(HL).C 

0013 

76 

HALT 

The  structure  of  this  program  is  the  same  as  the  structure  of  the  last  one.  The  most  sig- 
nificant bits  of  the  sum  now  must  be  initialized  and  stored.  The  processing  section  con- 
sists of  three  instructions  (ADD  A,(HL);  JR  NCCHCNT,  and  INC  C),  including  a  Condi- 
tional Jump. 

JR  NCCHCNT  causes  a  jump  to  memory  location  CHCNT  if  the  Carry  =  0.  Thus,  if  there 
IS  no  carry  from  the  8-bit  addition,  the  program  jumps  around  the  statement  that  incre- 
ments the  most  significant  bits  of  the  sum.  The  relative  offset  is: 

OOOB 
-OOOA 
01 

The  relative  offset  for  DJNZ  DSUMD  is: 

0006  ^  06 
-OOOD  +F3 
F9 

INC  C  adds  1  to  the  contents  of  Register  C.  Note  that  INC  BC  is  a  1 6-bit  increment  that 
adds  1  to  Register  C  and  adds  the  resulting  carry  to  Register  B;  INC  C  is  an  8-bit  incre- 
ment that  does  not  account  for  the  carry. 
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Number  of  Negative  Elements 

Purpose:  Determine  the  number  of  negative  elements  (most  significant  bit  1)  in  a 
block.  The  length  of  the  block  is  in  memory  location  0041  and  the  block  itself 
starts  in  memory  location  0042.  Place  the  number  of  negative  elements  in 
memory  location  0040. 

Sample  Problem: 

(0041)  =  06 

(0042)  =  68 

(0043)  =  F2 

(0044)  =  87 
(0046)  =  30 

(0046)  =  59 

(0047)  =  2A 

Result:    (0040)   =  02,  since  0043  and  0044  contain 
numbers  with  an  MSB  of  1. 

Flowchart:  f       start  ^ 


I 


Pointer  = 

41 

Count  = 

IPointer) 

Nneg  = 

0 

Pointer  =  Pointer  +  1 


(40)  =  Nneg 


Source  Program : 


SRNEG: 


CHCNT. 


Object  Program : 


LD 

HL,41H 

LD 

B,(HU 

;COUNT  =  NUMBER  OF  ELEMENTS 

LD 

CO 

;  NUMBER  OF  NEGATIVES  =  ZERO 

INC 

HL 

LD 

A,(HL) 

:GET  NEXT  ELEMENT 

AND 

A 

,JS  MSB  ZERO? 

JP 

P.CHCNT 

INC 

C 

:N0,  ADD  1  TO  NUMBER  OF  NEGATIVES 

DJNZ 

SRNEG 

LD 

A.C 

:STORE  NUMBER  OF  NEGATIVES 

LD 

!40H),A 

HALT 

Memory  Address 
(Hex) 

Memory  Contents 
\Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL,41H 

0001 

41 

0002 

00 

0003 

46 

LD 

B,{HU 

0004 

OE 

LD 

CO 

0005 

00 

0006 

23 

SRNEG: 

INC 

HL 

0007 

7E 

LD 

A.lHL) 

0008 

A7 

AND 

A 

0009 

F2 

JP 

P.CHCNT 

OOOA 

OD 

OOOB 

00 

OOOC 

OC 

INC 

C 

OOOD 

10 

CHCNT; 

DJNZ 

SRNEG 

OOOE 

F7 

OOOF 

79 

LD 

A.C 

0010 

32 

LD 

(40H),A 

0011 

40 

0012 

00 

0013 

76 

HALT 

AND  A  simply  sets  the  flag  bits  according  to  the  contents  of  the  Accumulator  v\(ithout 
affecting  those  contents;  OR  A  has  the  same  effect.  This  is  necessary  since  merely  load- 
ing the  Accumulator  does  not  affect  the  flags. 

JP  P.CHCNT  requires  a  full  16-bit  address.  There  is  no  relative  jump  on  the  Sign  flag  like 
there  is  on  the  Carry  and  Zero  flags. 

Note  that  all  we  really  want  to  do  is  test  the  yalue  of  bit  7  of  the  memon/  location  ad- 
dressed by  Registers  H  and  L.  The  Z80  has  a  special  bit  testing  instruction.  BIT.  that  is 
designed  specifically  for  this  purpose.  BIT  sets  the  Z  flag  to  the  complement  of  the  indi- 
cated bit  within  the  indicated  register  or  memory  location.  For  example,  BIT  5,D  will  set 
Z  to  1  if  bit  5  of  Register  D  is  zero,  and  to  0  if  bit  5  of  Register  D  is  one.  An  implementa- 
tion of  this  alternatiye  is  as  follows. 
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Source  Program: 


SRNEG: 


CHCNT 


Object  Program: 


LD 

HL.41  H 

LD 

B,(HL) 

;COUNT  =  NUMBER  OF  ELEMENTS 

LD 

CO 

•.NUMBER  OF  NEGATIVES  =  ZERO 

INC 

HL 

BIT 

7,(HL) 

:IS  NEXT  ELEMENT  NEGATIVE? 

JR 

Z.CHCNT 

INC 

C 

;YES,  ADD  1  TO  NUMBER  OF  NEGATIVES 

DJNZ 

SRNEG 

LD 

A,C 

:STORE  NUMBER  OF  NEGATIVES 

LD 

(40H),A 

HALT 

Memory  Address 

ineXJ 

Memory  Contents 
\nex/ 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL.41  H 

0001 

41 

0002 

00 

0003 

46 

LD 

B,(HL) 

0004 

OE 

LD 

CO 

0005 

00 

0006 

23 

SRNEG; 

INC 

HL 

0007 

CB 

BIT 

7.(HL) 

0008 

7E 

0009 

28 

JR 

Z.CHCNT 

OOOA 

01 

OOOB 

00 

INC 

C 

OOOC 

10 

CHCNT: 

DJNZ 

SRNEG 

OOOD 

F8 

OOOE 

79 

LD 

A.C 

OOOF 

32 

LD 

(40H),A 

0010 

40 

0011 

00 

0012 

76 

HALT 

Di  I  /.irtu  sets  tne  c  on  it  oit  /  or  tne  memory  location  aaaressea  oy  negisters  h  ana  l  is 
zero,  and  clears  the  Z  bit  if  bit  7  of  that  location  is  one.  BIT  does  not  affect  any  registers 
or  memory  locations. 

This  program  uses  JR  Z.CHCNT  since  no  incrementing  is  necessary  If  the  addressed  bit 
is  zero. 

Still  another  approach  would  be  to  use  the  instruction  RLC  (HL)  to  shift  the  sign  bit  of 
the  data  in  memory  to  the  Carry.  The  required  jump  would  then  be  JR  NC.CHCNT. 
Howeyer,  this  approach  uses  extra  time  (RLC  (HL)  takes  15  cycles  as  compared  to  the 
12  needed  by  BIT  7,(HL))  and  also  changes  the  data  in  memory  which  may  be  needed 
for  other  purposes.  Note  that  these  disadyantages  are  related:  the  extra  time  is  needed 
to  return  the  result  to  the  memory  location. 

Find  Maximum 

Purpose:  Find  the  largest  element  in  a  block  of  data.  The  length  of  the  block  is  in 
memory  location  0041  and  the  block  itself  begins  in  memor/  location  0042. 
Store  the  maximum  in  memory  location  0040.  Assume  that  the  numbers  in 
the  block  are  all  8-bit  unsigned  binary  numbers. 
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Sample  Problem: 


(0041) 
(0042) 
(0043) 
(0044) 
(0045) 
(0046) 

Result:  (0040) 


05 
67 
79 
15 
E3 
72 

E3.  since  this  is  the  largest  of 
the  five  unsigned  numbers. 


Flowchart: 


CIE-D 


Pointer  = 

41 

Count  = 

(Pointer) 

Max  = 

0 

Max 

=  (Pointer) 

Count 

=  Count  -  1 
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Source  Program: 


LD 

HL,41  H 

.POINT  TO  COUNT 

LD 

B,(HL) 

:COUNT  =  NUMBER  OF  ELEMENTS 

SUB 

A 

:MAXIMUM  =  MINIMUM  PObblBLt  VALUt  (ZEHO) 

NEXTE; 

INC 

HL 

CP 

(HL) 

:IS  NEXT  ELEMENT  ABOVE  MAXIMUM? 

JR 

NC.DECNT 

LD 

A,(HL) 

:YES,  REPLACE  MAXIMUM  WITH  ELEMENT 

DECNT; 

DJNZ 

NEXTE 

LD 

(40HI,A 

•.SAVE  MAXIMUM 

HALT 

Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL.41H 

0001 

41 

0002 

00 

0003 

46 

LD 

B.(HL) 

0004 

97 

SUB 

A 

0005 

23 

NEXTE: 

INC 

HL 

0006 

BE 

CP 

(HL) 

0007 

30 

JR 

NC.DECNT 

0008 

01 

0009 

7E 

LD 

A.(HL) 

OOOA 

10 

DECNT; 

DJNZ 

NEXTE 

OOOB 

F9 

OOOC 

32 

LD 

(40H).A 

OOOD 

40 

OOOE 

00 

OOOF 

76 

HALT 

The  relatiye  offset  for  JR  NC.DECNT  is: 

OOOA 
-0009 
01 

The  relatiye  offset  for  DJNZ  NEXTE  is: 

0005  ^  05 
-OOOC  +F4 
F9 

The  first  three  instructions  of  this  program  form  the  initialization  section. 

This  program  takes  advantage  of  the  fact  that  zero  is  the  smallest  8-bit  unsigned  binary 
number.  When  you  set  the  register  that  contains  the  maximum  value  —  in  this  case  the 
Accumulator  —  to  the  minimum  possible  value  before  you  enter  the  loop,  then  the  pro- 
gram will  set  the  Accumulator  to  a  larger  value  unless  all  the  elements  in  the  array  are 
zeros. 
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The  program  works  properly  if  there  are  two  elements,  but  not  if  there  are  one  or  none 
at  alJ  Why'  How  could  you  solve  this  problem? 

The  instruction  CP  (HU  sets  the  Carry  flag  as  follows  (ELEMENT  is  the  contents  of  the 
address  in  Registers  H  and  L  and  MAX  is  the  contents  of  the  Accumulator): 


If  CARRY  =  0.  the  program  proceeds  to  DECNT  and  does  not  change  the  maximum.  If 
CARRY  =  1.  the  program  replaces  the  old  maximum  with  the  current  element  by  ex- 
ecuting the  instruction  LD  A,(HL). 

The  program  does  not  work  if  the  numbers  are  signed  because  negative  numbers  will 
appear  to  be  larger  than  positive  numbers.  The  problem  is  somewhat  tricky  because 
overflow  could  make  the  result  appear  to  have  the  wrong  sign. 

Remember  that  overflow  occurs  when  the  magnitude  of  a  result  affects  its  sign  bit.  The 
Z80  has  a  Parity /Overflow  flag  that  indicates  when  twos  complement  overflow  has  oc- 
curred. Arithmetic  operations  that  result  in  overflow  set  this  flag.  You  can  then  test  its 
value  With  the  instructions  JP  PE.ADDR  (Jump  on  Parity  Even  —  or  Jump  on  Overflow) 
or  JP  PO.ADDR  (Jump  on  Parity  Odd  — or  Jump  on  No  Overflow).  One  thing  you  may 
have  to  watch  is  that  this  Z80  usage  is  inconsistent  with  the  8080A  or  8085 
microprocessors,  which  always  use  the  P  flag  to  indicate  parity.  The  8080A  and  8085 
microprocessors  have  no  overflow  indicator. 

Justify  a  Binary  Fraction 

Purpose:  Shift  the  contents  of  memory  location  0040  left  until  the  most  significant  bit 
of  the  number  is  1 .  Store  the  result  in  memory  location  0041  and  the  number 
of  left  shifts  required  in  memory  location  0042.  If  the  contents  of  memory 
location  0040  are  zero,  clear  both  0041  and  0042. 

Note:  The  process  is  |ust  like  converting  a  number  to  a  scientific  notation:  for  example: 


CARRY  =  1  if  ELEMENT  >  MAX 
CARRY  =  0  if  ELEMENT  <  MAX 


0.0057  =  5.7x  10' 


,-3 


Sample  Problems: 


a. 


(0040)   =  22 
Result:   (0041)   =  88 


b. 


(0042)  =  02 
(0040)   =  01 


Result:   (0041)    =  80 


c. 


(0042)  =  07 
(0040)   =  CB 


Result:    (0041)    =  CB 


d. 


(0042)  =  00 
(0040)   =  00 


Result:   (0041)    =  00 
(0042)   =  00 
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Flowchart: 


Source  Program: 


DONE: 


LD 

B.O 

:NUMBER  OF  SHIFTS  =ZERO 

LD 

HL,40H 

LD 

A,(HL) 

;GET  DATA 

AND 

A 

:IS  DATA  ZERO' 

JR 

Z.DONE 

;YES,  DONE 

JP 

M.DONE 

:DONE  IF  SIGN  BIT  IS  ONE 

INC 

B 

:ADD  1  TO  NUMBER  OF  SHIFTS 

ADD 

A.A 

:SHIFT  LEFT  ONE  BIT 

JP 

CHKMS 

INC 

HL 

LD 

(HL),A 

:SAVE  JUSTIFIED  DATA 

INC 

HL 

LD 

(HU,B 

:SAVE  NUMBER  OF  SHIFTS 

HALT 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

in  ex/ 

(Mnemonic) 

0000 

06 

LD 

B.O 

0001 

00 

0002 

21 

LD 

HL,40H 

0003 

40 

0004 

00 

0005 

7E 

LD 

A,(HL) 

0006 

A7 

AND 

A 

0007 

28 

JR 

Z,DONE 

0008 

08 

0009 

FA 

CHKMS: 

JP 

M.DONE 

OOOA 

11 

OOOB 

00 

OOOC 

04 

INC 

B 

GOOD 

87 

ADD 

A.A 

JP 

CHKMS 

OOOF 

09 

0010 

00 

0011 

23 

DONE: 

INC 

HL 

0012 

77 

LD 

(HU.A 

0013 

23 

INC 

HL 

0014 

70 

LD 

(HU.B 

0015 

76 

HALT 

JP  M.DONE  causes  a  jump  to  location  DONE  if  the  Sign  bit  is  1.  This  condition  may 
mean  that  the  last  result  was  a  negative  number  or  may  just  mean  that  its  most  signifi- 
cant bit  was  1  —  the  computer  supplies  only  the  results;  the  programmer  must  provide 
the  interpretation. 

ADD  A.A  adds  the  number  in  the  Accumulator  to  itself.  The  program  uses  this  instruc- 
tion, rather  than  RLA  or  RLCA.  because  ADD  A  affects  the  Sign  bit  while  RLA  and  RLCA 
do  not. 

We  could  reorganize  this  program  so  as  to  eliminate  an  extraneous  JP  and  use  relative 
rather  than  absolute  jumps.  One  reorganized  version  would  be: 

:NUMBER  OF  SHIFTS  =  ZERO 


GET  DATA 

IS  DATA  ZERO? 

YES,  DONE 

ADJUST  NUMBER  OF  SHIFTS  BACK  ONE 
ADD  1  TO  NUMBER  OF  SHIFTS 
SHIFT  LEFT  ONE  BIT 
CONTINUE  IF  MSB  NOT  ONE 
ADJUST  DATA  BACK 


CHKMS: 


DONE: 


LD 

B.O 

LD 

HL,40H 

LD 

A.iHLi 

AND 

A 

JR 

Z.DONE 

DEC 

B 

INC 

B 

RLA 

JR 

NC.CHKMS 

RRA 

INC 

HL 

LD 

(HU.A 

INC 

HL 

LD 

(HU.D 

HALT 

iSAVE  JUSTIFIED  DATA 


:SAVE  NUMBER  OF  SHIFTS 


Show  that  this  version  also  works.  What  are  its  advantages  and  disadvantages  as  com- 
pared to  the  previous  program? 
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PROBLEMS 

1)  Checksum  of  Data 

Purpose:  Calculate  the  checksum  of  a  series  of  numbers.  The  length  of  the  series  is  in 
memory  location  0041  and  the  senes  itself  begins  in  memory  location  0042. 
Store  the  checksum  in  memory  location  0040.  The  checksum  is  formed  by 
Exclusive-ORing  all  the  numbers  in  the  series  together. 

Note:  Such  checksums  are  often  used  m  paper  tape  and  cassette  systems  to  ensure 
that  the  data  has  been  read  correctly.  The  calculated  checksum  is  compared  to 
the  one  stored  with  the  data  —  if  the  two  checksums  do  not  agree,  the  system 
will  usually  either  indicate  an  error  to  the  operator  or  automatically  read  the  data 
again. 

Sample  Problem: 

(0041)  =  03 

(0042)  =  28 

(0043)  =  55 

(0044)  =  26 

Result:    (0040)   =  (0042)  ©  (0043)  ©  (0044) 
=  28©55©26 
=  00  10  1000 
©  0  10  10  10  1 

0  111110  1 
©  00100110 

0  10  110  11 
=  5B 

2)  Sum  of  16- Bit  Data 

Purpose:  Calculate  the  sum  of  a  series  of  1 6-bit  numbers.  The  length  of  the  series  is  in 
memory  location  0042  and  the  series  itself  begins  in  memory  location  0043. 
Store  the  sum  in  memory  locations  0040  and  0041  (eight  most  significant 
bits  in  0041).  Each  16-bit  number  occupies  two  memory  locations,  with  the 
eight  most  significant  bits  in  the  higher  address.  Assume  that  the  sum  can 
be  contained  in  16  bits. 

Sample  Problem: 

(0042)  =  03 

(0043)  =  F1 

(0044)  =  28 

(0045)  =  1A 

(0046)  =  30 

(0047)  =  89 

(0048)  =  48 

Result:  28F1  -I-  301 A  +  4B89  =A494 

(0040)  =  94 

(0041)  =  A4 
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3)  Number  of  Zero,  Positive,  and  Negative  Numbers 

Purpose:  Determine  the  number  of  zero,  positive  (most  significant  bit  zero  but  entire 
number  not  zero),  and  negative  (most  significant  bit  1)  elements  in  a  block. 
The  length  of  the  block  is  in  memory  location  0043  and  the  block  itself  starts 
in  memory  location  0044.  Place  the  number  of  negative  elements  in  memory 
location  0040,  the  number  of  zero  elements  in  memory  location  0041,  and 
the  number  of  positive  elements  in  memory  location  0042. 

Sample  Problem: 

(0043)  =  06 

(0044)  =  68 

(0045)  =  F2 

(0046)  =  87 

(0047)  =  00 

(0048)  =  59 

(0049)  =  2A 

Result:  2  negative,  1  zero,  and  3  positive,  so 

(0040)  =  02 

(0041)  =  01 

(0042)  =  03 

4)  Find  Minimum 

Purpose:  Find  the  smallest  element  in  a  block  of  data.  The  length  of  the  block  is  in 
memory  location  0041  and  the  block  itself  begins  in  memor/  location  0042. 
Store  the  minimum  in  memory  location  0040.  Assume  that  the  numbers  in 
the  block  are  8-bit  unsigned  binary  numbers. 

Sample  Problem: 

(0041)  =  05 

(0042)  =  67 

(0043)  =  79 

(0044)  =  15 

(0045)  =  E3 

(0046)  =  72 

Result:    (0040)    =   15,  since  this  is  the  smallest  of  the 
five  unsigned  numbers. 

5)  Count  1  Bits 

Purpose:  Determine  how  many  bits  in  memory  location  0040  are  one  and  place  the 
result  in  memory  location  0041. 

Sample  Problem: 

(0040)    =  3B  =00111011 
Result:   (0041)    =  05 
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Chapter  6 
CHARACTER-CODED  DATA 


Microprocessors  often  handle  character-coded  data.  Not  only  do  keyboards, 
teletypewriters,  communications  devices,  displays,  and  computer  terminals  expect  or 
provide  character-coded  data;  many  instruments,  test  systems,  and  controllers  also  re- 
quire data  in  this  form.  The  most  commonly  used  code  is  ASCII.  Baudot  and  EBCDIC  are 
found  less  frequently.  We  will  assume  all  of  our  character-coded  data  to  be  V-bit  ASCII 
with  the  most  significant  bit  zero  (see  Table  6-1). 

Some  pnnciples  to  remember  in  handling  ASCII-coded  data  are: 

1)  The  codes  for  the  numbers  and  letters  form  ordered  sub-se- 
quences. The  codes  for  the  decimal  numbers  are  hex  30 
through  39,  so  that  you  can  convert  between  decimal  and 
ASCII  with  a  simple  additive  factor.  The  codes  for  the  upper-case  letters  are  hex  41 
through  5A,  so  that  you  can  do  alphabetic  ordering  by  sorting  the  data  in  increas- 
ing numerical  order. 

2)  The  computer  draws  no  distinction  between  printing  and  non-printing  characters. 
This  distinction  is  made  only  by  I/O  devices. 

3)  An  ASCII  device  will  handle  only  ASCII  data.  To  print  a  7  on  an  ASCII  printer,  the 
microprocessor  must  send  hex  37  to  the  printer:  hex  07  is  the  'bell'  character. 
Similarly,  the  microprocessor  will  receive  the  character  9  from  an  ASCII  keyboard 
as  hex  39;  hex  09  is  the  'tab'  character. 

4)  Some  ASCII  devices  do  not  use  the  full  character  set.  For  example,  control  charac- 
ters and  lower-case  letters  may  be  ignored  or  pnnted  as  spaces  or  question  marks. 

5)  Some  widely  used  .ASCII  characters  are: 
OA., g  -  line  feed  (LF) 

OD.,g  -  carriage  return  (CR) 

20.,g  -  space 

3F^g  -  '  (question  mark) 

7F.,g  -  rubout  or  delete  character 

6)  Each  ASCII  character  occupies  seven  bits.  This  allows  a  large  character  set  but  is 
wasteful  when  the  data  is  limited  to  a  small  subset  such  as  the  decimal  numbers. 
An  8-bit  byte,  for  example,  can  hold  only  one  ASCII-coded  decimal  digit,  while  i' 
can  hold  two  BCD-coded  digits. 


HANDLING 
DATA  IN 
ASCII 
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Table  6-1.  Hex-ASCII  Table 


H®K  LSD  ^^-^ 

0 

1 

Z 

3 

4 

6 

6 

7 

u 

Mt  tl 

INUL 

ni  c 
ULc 

CD 

U 

D 

r 

P 

1 
1 

own 

nn 

I 

1 

A 

n 

3 

Q 

9 

STX 

9 

□ 
□ 

R 

n 

h 
u 

r 

FTX 

if 

O 

p 

c 
o 

5 

£l 

FDT 

A 

^■ 

T 

1 

U 

t 

5 

FMH 

NAK 

/o 

D 

p 

u 

6 

U 

w 

SYN 

o. 

a 

R 

u 

p 

V 

f 

V 

RFI 
□  tzt- 

FTR 

"7 

VV 

9 

w 

8 

BS 

CAN 

( 

8 

H 

X 

h 

X 

9 

HT 

EM 

) 

9 

Y 

i 

y 

A 

LF 

SUB 

J 

Z 

z 

B 

VT 

ESC 

+ 

K 

[ 

k 

1 

C 

FF 

FS 

< 

L 

\ 

1 

1 

D 

CR 

GS 

M 

] 

m 

1 

E 

SO 

RS 

> 

N 

A 

n 

F 

SI 

US 

/ 

7 

0 

0 

DEL 

EXAMPLES 

Length  of  a  String  of  Characters 

Purpose:  Determine  the  length  of  a  string  of  ASCII  characters  (seven  bits  with  most 
significant  bit  zero).  The  string  starts  in  memory  location  0041:  the  end  of 
the  string  is  marked  bv  a  carriage  return  character  CCR',  hex  CD).  Place  the 
length  of  the  string  (excluding  the  carriage  return)  into  memory  location 
0040. 


Sample  Problems: 


Result: 


(0041) 

(0040) 

(0041) 
(0042) 
(0043) 
(0044) 
(0045) 
(0046) 
(0047) 


00 

00 

52 
41 
54 
48 
45 
52 
OD 


since  the  first  character  is  a  carnage  return. 

•R' 
'A- 
T' 
■H' 
■E' 
■R' 
CR 


Result:    (0040)    =  06 
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Flowchart: 


Source  Program: 


CHKCR: 


DONE: 


LD 

HL41H 

:POINTER  =  START  OF  STRING 

LD 

B,0 

;STRING  LENGTH  =ZERO 

LD 

A.ODH 

:GET  ASCII  CARRIAGE  RETURN  TO  COMPARE 

CP 

(HU 

;IS  CHARACTER  A  CARRIAGE  RETURN? 

JR 

Z.DONE 

:YES.  DONE 

INC 

B 

;N0.  ADD  1  TO  STRING  LENGTH 

INC 

HL 

JR 

CHKCR 

;TRY  NEXT  CHARACTER 

LD 

A,B 

:SAVE  STRING  LENGTH 

LD 

!40H),A 

HALT 
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Object  Program: 


IVifc;!  1  iUi  V  ^UUi  tJoo 

ivicinuiy  VfUtilciito 

Instruction 

{Hoy! 

\t  ica; 

(Mnemonic) 

0000 

21 

t  n 

0001 

41 

0002 

00 

0003 

06 

LD 

B.O 

0004 

00 

0005 

3E 

LD 

A.ODH 

0006 

OD 

0007 

BE 

CHKCR: 

CP 

(HL) 

0008 

28 

JR 

Z.DONE 

0009 

04 

OOOA 

04 

INC 

B 

OOOB 

23 

INC 

HL 

1  Q 
1  0 

JR 

CHKCR 

OOOD 

F9 

OOGE 

78 

DONE: 

LD 

A,B 

OOOF 

32 

LD 

(40H).A 

0010 

40 

0011 

00 

0012 

76 

HALT 

The  carriage  return  !CR)  is  just  another  ASCII  character  (hex  OD)  as  far  as  the  computer 
IS  concerned.  The  fact  that  the  output  device  treats  the  carnage  return  as  a  control 
character  rather  than  as  a  printing  character  does  not  affect  the  computer. 


The  Compare  instruction,  CP,  sets  the  flags  as  if  a  subtraction  had  been  performed,  but 
leaves  the  carnage  return  character  m  the  Accumulator  for  later  comparisons.  The  Zero 
(Z)  flag  IS  affected  as  follows; 

Z  =  1    if  the  character  in  the  string  is  a  carriage  return 

Z  =  0    if  It  is  not  a  carriage  return 

The  instruction  INC  B  adds  1  to  the  string  length  counter  in  Register  B.  LD  B.O  initializes 
this  counter  to  zero  before  the  loop  begins.  Remember  to  initialize  variables  before 
using  them  in  a  loop. 

This  loop  does  not  terminate  because  a  counter  is  decremented  to  zero.  The  computer 
will  simply  continue  examining  characters  until  it  finds  a  carnage  return.  You  may  have 
to  place  a  maximum  count  in  a  loop  like  this  to  avoid  problems  with  erroneous  strings 
that  do  not  contain  a  carriage  return.  What  would  happen  if  the  example  program  were 
used  with  such  a  stnng? 

Note  that,  by  rearranging  the  logic  and  changing  the  initial  conditions,  you  can  shorten 
the  program  and  decrease  its  execution  time.  If  we  adjust  the  flowchart  so  that  the  pro- 
gram increments  the  counter  and  pointer  before  it  looks  for  the  carriage  return,  only  one 
Jump  instruction  is  necessarv  instead  of  two.  The  new  flowchart  and  program  are  as 
follows: 
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Flowchart: 


Source  Program: 


LD 

HL,40H 

POINTER  =  BYTE  BEFORE  STRING 

LD 

B.OFFH 

LENGTH  =-1 

LD 

A,ODH 

GET  ASCII  CARRIAGE  RETURN  TO  COMPARE 

iNC 

HL 

INC 

B 

ADD  1  TO  STRING  LENGTH 

CP 

(HL) 

IS  CHARACTER  A  CARRIAGE  RETURN? 

JR 

NZ.CHKCR 

NO,  CHECK  NEXT  CHARACTER 

LD 

A.B 

YES.  SAVE  STRING  LENGTH 

LD 

(40H).A 

HALT 

Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

06 

LD 

B.OFFH 

0004 

FF 

0005 

3E 

LD 

A.ODH 

0006 

OD 

0007 

23 

HL 

0008 

04 

INC 

B 

0009 

BE 

CP 

(HL) 

OOOA 

20 

JR 

NZ.CHKCR 

OOOB 

FB 

OOOC 

78 

LD 

A.B 

OOOD 

32 

LD 

(40H),A 

OOOE 

40 

OOOF 

00 

0010 

76 

HALT 

The  task  of  looking  for  a  particular  value  in  a  list,  table,  or  string  is  a  common  one.  The 
Z80  microprocessor  has,  in  fact,  special  instructions  that  simplify  this  task. 

These  special  instructions  are  called  Block  Search  Instructions: 
they  operate  as  follows: 


BLOCK 
SEARCH 
INSTRUCTIONS 


CPl  compares  the  contents  of  the  memory  location  addressed  by 
HL  with  the  contents  of  the  Accumulator  (just  like  CP  (HL)).  It  then 
increments  HL  and  decrements  the  byte  counter  (register  pair  BC).  The  Parity/Overflow 
bit  IS  reset  if  the  byte  counter  is  decremented  to  zero  and  set  otherwise.  CPD  is  the 
same  instruction  except  that  it  decrements  HL  instead  of  incrementing  it. 

CPIR  and  CPDR  are  the  repeated  forms  of  the  Block  Search  instructions.  These  instruc- 
tions repeat  the  basic  Search  instruction  until  either  BC  is  decremented  to  zero  or  a  true 
comparison  occurs  (i.e.,  A  =  (HL)).  Remember  that  decrementing  BC  to  zero  resets  the 
Parity/Overflow  bit,  while  finding  a  match  sets  the  Zero  bit. 

Note  that  BC  contains  a  16-bit  counter.  Thus,  the  Block  Search  Instructions  can  handle 
strings  of  any  length. 

A  version  of  the  previous  program  using  CPl  is  shown  below. 
Source  Program: 


CHKCR: 


LD 

HL,41H 

POINTER  =  START  OF  STRING 

LD 

BCO 

BYTE  COUNTER  =  ZERO 

LD 

A,ODH 

GET  ASCII  CARRIAGE  RETURN  TO  COMPARE 

CPl 

IS  CHARACTER  A  CARRIAGE  RETURN? 

JR 

NZ.CHKCR 

NO,  CHECK  NEXT  CHARACTER 

LD 

A.OFFH 

YES,  CALCULATE  STRING  LENGTH 

SUB 

C 

LD 

(40H),A 

SAVE  STRING  LENGTH 

HALT 
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Object  Program: 


Memorv  Address 

Memory  Contents 

Instruction 

\nex/ 

\nexi 

(Mnemonic) 

0000 

21 

i  n 

l-^i  41  M 
ni  *+  1  n 

0001 

41 

0002 

00 

0003 

01 

LD 

SCO 

0004 

00 

0005 

00 

0006 

3E 

1  n 

0007 

OD 

0008 

ED 

0009 

A1 

OOOA 

20 

JR 

NZ.CHKCR 

OOOB 

FC 

OOOC 

3E 

LD 

A.OFFH 

OOOD 

FF 

OOOE 

91 

SUB 

C 

OOOF 

32 

LD 

(40H),A 

0010 

40 

0011 

00 

0012 

76 

HALT 

A  little  manipulation  is  necessary  to  calculate  the  string  length,  since  CPI  decrements 
the  byte  counter  (BC)  instead  of  incrementing  it  as  we  did  with  INC  B  in  the  earlier  pro- 
gram. Also,  the  byte  counter  is  decremented  one  extra  time  when  the  carriage  return  is 
found.  How  could  you  adjust  the  initial  conditions  to  handle  this  problem? 


In  fact,  we  can  improve  the  program  even  further  by  using  CPIR  to  remove  the  need  for 
the  relative  lump  JR.  CPIR  does  everything  that  CPI  does,  but  it  also  automatically 
repeats  the  comparison  procedure  unless  A  =  (HL)  or  BC  has  been  decremented  to  zero. 
The  program  using  CPIR  is  shown  below. 

Source  Program: 


LD 

HL,41H 

;POINTER  =  START  OF  STRING 

LD 

BCD 

;BYTE  COUNTER  =  ZERO 

LD 

A.ODH 

:GET  ASCII  CARRIAGE  RETURN  TO  COMPARE 

CPIR 

iSEARCH  FOR  CARRIAGE  RETURN 

LD 

A.OFFH 

■.CALCULATE  STRING  LENGTH  FROM  COUNTER 

SUB 

C 

LD 

(40H),A 

;SAVE  STRING  LENGTH 

HALT 

6-7 


Object  Program: 


Memory  Address 
(Hex) 


Memorv  Contents 
(Hexl 


Instruction 
(Mnemonic) 


0000 

21 

LD 

HL.41H 

0001 

41 

0002 

00 

0003 

01 

LD 

SCO 

0004 

00 

0005 

00 

0006 

3E 

LD 

A.ODH 

UUU/ 

UU 

0008 

ED 

CPIR 

0009 

B1 

OOOA 

3E 

LD 

A.OFFH 

OOOB 

FF 

OOOC 

91 

SUB 

C 

GOOD 

32 

LD 

(40H),A 

OOOE 

40 

OOOF 

00 

0010 

76 

HALT 

The  multiple  operation  instructions  like  CPI  and  CPIR  have  the  same  effect  as  the  se- 
quences thev  replace.  The  savings  in  execution  time  and  memory  come  about  because 
the  processor  needs  fewer  instructions  for  each  pass  through  the  loop.  Thus,  the  real 
savings  is  in  loop  execuion. 

All  these  programs  assume  that  the  string  is  less  than  256  bvtes  long.  How  would  you 
change  them  to  handle  longer  strings? 

Find  First  Non-Blani<  Character 

Purpose:  Search  a  string  of  .ASCII  characters  (seven  bits  with  most  significant  bit  zero) 
for  a  non-blank  character.  The  string  starts  in  memory  location  0042.  Place 
the  address  of  the  first  non-blank  character  into  memory  locations  0040  and 
0041  (most  significant  bits  in  0041).  A  blank  character  is  hex  20  in  ASCII. 

Sample  Problems: 


(0042) 

37 

7- 

(0040) 

42. 

since  memorv 

character. 

(0041) 

00 

(0042) 

20 

SP 

(0043) 

20 

SP 

(0044) 

20 

SP 

(0045) 

46 

F 

(0046) 

20 

SP 

(0040) 

45, 

since  the  three 

contain  blanks. 

(0041) 

00 
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Flowchart: 


Source  Program: 


LD 

HL,42H 

:POINTER  =  START  OF  STRING 

LD 

A,20H 

:GET  ASCII  SPACE  FOR  COMPARISON 

CHBLK: 

CP 

(HL) 

;IS  CHARACTER  AN  ASCII  SPACE? 

JR 

NZ.DONE 

:N0,  THROUGH 

INC 

HL 

JR 

CHBLK 

■.YES,  EXAMINE  NEXT  CHARACTER 

DONE: 

LD 

(40H),HL 

:N0,  SAVE  ADDRESS  OF  FIRST  NON-BLANK 

CHARACTER 

HALT 


Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL.42H 

0001 

42 

0002 

00 

0003 

3E 

LD 

A.20H 

0004 

20 

0005 

BE 

CHBLK. 

CP 

(HL) 

0006 

20 

JR 

NZ.DONE 

0007 

03 

0008 

23 

INC 

HL 

0009 

18 

JR 

CHBLK 

OOOA 

FA 

OOOB 

22 

DONE; 

LD 

(40H),HL 

OOOC 

40 

OOOD 

00 

OOOE 

76 

HALT 
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Looking  for  spaces  in  strings  is  a  common  task.  Spaces  often  are  eliminated  from 
strings  when  they  are  used  simply  to  increase  readability  or  to  fit  particular  formats.  It  is 
obviously  wasteful  to  store  and  transmit  beginning,  ending  or  extra  spaces,  particularly 
if  you  are  paying  for  the  communications  capability  and  memory  required.  Data  and 
program  entry,  however,  are  much  simpler  if  extra  spaces  are  tolerated.  Microcom- 
puters are  often  used  in  situations  like  this  to  convert  data  between  forms  that  are  easy 
for  humans  to  use  and  forms  that  are  efficiently  handled  on  computers  and  com- 
munications lines. 

The  instruction  LD  (addr),HL  is  convenient  for  storing  addresses  in  the  Z80  format  (least 
significant  byte  first).  LD  (40H),HL  stores  the  contents  of  Register  L  in  memory  location 
0040  and  the  contents  of  Register  H  in  memory  location  0041. 

-Again,  if  we  alter  the  initial  conditions  so  that  the  loop  control  section  precedes  the  pro- 
cessing section,  we  can  reduce  the  number  of  bytes  in  the  program  and  decrease  the 
loop's  execution  time.  The  rearranged  flowchart  is; 


Source  Program: 


CHBLK: 


LD 

HL,41H 

LD 

A,20H 

INC 

HL 

CP 

(HL) 

JR 

Z.CHBLK 

LD 

(40H),HL 

HALT 

: POINT  TO  BYTE  BEFORE  STRING 
:GET  ASCII  SP.ACE  FOR  COMPARISON 

;IS  CHARACTER  .AN  ASCII  SPACE? 
;YES.  KEEP  EXAMINING  CHARACTERS 
:N0,  SAVE  ADDRESS  OF  FIRST  NON-BLANK 
,  CHARACTER 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

91 

LD 

HL,41H 

nnni 

f  ! 

uuu^ 

uu 

uuuo 

oc 

LD 

A,20H 

UUU't 

0005 

23 

CHBLK;  INC 

HL 

0006 

BE 

CP 

(HL) 

0007 

28 

JR 

Z.CHBLK 

0008 

FC 

0009 

22 

LD 

(40H),HL 

OOOA 

40 

OOOB 

00 

OOOC 

76 

HALT 

As  in  the  previous  example,  we  could  replace  the  sequence  INC  HL,  CP  (HL)  with  the 
single  instruction  CPI.  However,  since  we  do  not  need  the  byte  counter  m  this  program, 
CPI  takes  just  as  much  memory  (two  bytes)  and  more  time  (16  clock  cycles  Instead  of 
1 3)  than  the  instructions  it  replaces.  We  could  not  use  CPIR  here  since  we  want  the  pro- 
gram to  terminate  when  the  characters  are  not  the  same. 


Replace  Leading  Zeros  with  Blanks 

Purpose:  Edit  a  string  of  ASCII  decimal  characters  by  replacing  all  leading  zeros  with 
blanks.  The  string  starts  in  memory  location  0041 ;  assume  that  it  consists 
entirely  of  ASCII-coded  decimal  digits.  The  length  of  the  string  is  in  memory 
location  0040. 

Sample  Problems: 

a.  (0040)   =  02 

(0041)   =  36  'O' 

The  program  leaves  the  string  unchanged,  since  the  leading  digit  is  not  zero. 


(0040) 

=  08 

(0041) 

=  30 

•0' 

(0042) 

=  30 

■O' 

(0043) 

=  38 

•8' 

Result:  (0041) 

=  20 

SP 

(0042) 

=  20 

SP 
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Flowchart: 


Source  Program: 


CHKZ; 


DONE; 


LD 

HL.40H 

LD 

B.(HL) 

LD 

a;o' 

INC 

HL 

CP 

(HL) 

JR 

NZ.DONE 

LD 

(HU,20H 

DJNZ 

CHKZ 

HALT 

.■COUNT  =  STRING  LENGTH 

;GET  ASCII  ZERO  FOR  COMPARISON 

;IS  LEADING  DIGIT  ZERO? 
;N0.  THROUGH 

.REPLACE  LEADING  ZERO  WITH  BLANK 
lEXAMINE  NEXT  DIGIT  IF  ANY 


Single  quotation  marks  around  characters  indicate  ASCII. 
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Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL.40H 

0001 

0002 

00 

0003 

LD 

B,(HL) 

0004 

LD 

A.'O' 

0005 

0006 

INC 

HL 

0007 

BE 

CP 

(HL) 

0008 

20 

JR 

NZ.DONE 

0009 

04 

OOOA 

36 

LD 

(HL),20H 

OOOB 

20 

OOOC 

10 

DJNZ 

CHKZ 

OOOD 

F8 

OOOE 

76 

DONE: 

HALT 

You  will  frequently  want  to  edit  decimal  strings  before  they  are  printed  or  displayed  to 
improve  their  appearance.  Common  editing  tasks  include  eliminating  leading  zeros, 
justifying  numbers,  adding  signs  or  other  identifying  markers,  and  rounding.  Clearly, 
printed  numbers  like  0006  or  $27.34382  can  be  confusing  and  annoying. 


Here  the  loop  has  two  exits  —  one  if  the  processor  finds  a  non-zero  digit  and  the  other  if 
it  has  examined  the  entire  string. 

The  instruction  LD  (HL),20H  places  20  (hex)  into  the  memory  location  addressed  by 
Registers  H  and  L.  You  could  also  initialize  Register  C  to  20  hex  (i.e..LD  C,20H)  and  use 
LD  (HL),C  to  replace  the  leading  zero  with  a  blank.  Note  the  tradeoffs  involved  in  this  ex- 
ample. LD  (HL),C  executes  faster  than  LD  (HL),20H  and  would  thus  decrease  the  inner 
loop's  execution  time.  The  overhead  required,  however,  is  an  LD  C.20H  Instruction  in 
the  initialization  section  of  the  routine.  If  this  example  were  to  be  used  in  a  cash  register 
application,  which  sequence  would  you  choose  and  why? 

All  digits  in  the  string  are  assumed  to  be  ASCII:  that  is.  the  digits  are  hex  30  through  39 
rather  than  the  ordinary  decimal  0  to  9.  The  conversion  from  decimal  to  ASCII  is  simply 
a  matter  of  adding  hex  30  to  the  decimal  digit. 

You  may  have  to  be  careful,  when  blanking  leading  zeros,  to  leave  one  zero  in  the  event 
that  all  the  digits  are  zero.  How  would  you  do  this? 

Note  that  each  ASCII  digit  requires  eight  bits,  as  compared  to  four  for  a  BCD  digit. 
Therefore,  ASCII  is  an  expensive  format  in  which  to  store  or  transmit  numerical  data. 

Add  Even  Parity  to  ASCII  Characters 

Purpose:  Add  even  parity  to  a  string  of  7-bit  ASCII  characters.  The  length  of  the  stnng 
IS  in  memory  location  0040  and  the  string  itself  begins  in  memory  location 
0041.  Place  even  parity  in  the  most  significant  bit  of  each  character  by  set- 
ting the  most  significant  bit  to  1  if  that  makes  the  total  number  of  1  bits  in 
the  word  an  even  number. 
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Sample  Problem: 


(0040) 
(0041) 
(0042) 
(0043) 
(0044) 
(0045) 
(0046) 

Result:  (0041) 
(0042) 
(0043) 
(0044) 
(0045) 
(0046) 


06 
31 
32 
33 
34 
35 
36 

B1 
B2 
33 
B4 
35 
36 


Flowchart: 


C-^Z ) 


Pointer 

=  41 

Count 

=  (40) 

(Pointer)  ~  {Pointer) 
OR  10000000B 
{set  paritv  bit) 


Pointer 

=  Pointer  +1 

Count 

=  Count  -  1 
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Source  Program: 


LD 

HL,40H 

LD 

B,(HL) 

;GET  STRING  LENGTH 

LD 

ClOOOOOOOB 

;GET  PARITY  BIT  OF  1 

INC 

HL 

LD 

A,(HL) 

:GET  A  CHARACTER 

OR 

C 

:SET  PARITY  BIT  TO  1  AND  TEST  PARITY 

JP 

PO.CHCNT 

:IS  PARITY  NOW  EVEN? 

LD 

(HU.A 

:YES,  SAVE  CHARACTER  WITH  EVEN  PARITY 

DJNZ 

SETPR 

HALT 

Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

46 

LD 

B,(HL) 

0004 

OE 

LD 

ClOOOOOOOH 

0005 

80 

0006 

23 

SETPR: 

INC 

HL 

0007 

7E 

LD 

A,(HL) 

0008 

81 

OR 

n 

0009 

E2 

JP 

PO.CHCNT 

OOOA 

OD 

OOOB 

00 

OOOC 

77 

LD 

(HU.A 

OOOD 

10 

CHCNT 

DJNZ 

SETPR 

OOOE 

F7 

OOOF 

76 

HALT 

Parity  is  often  added  to  ASCII  characters  before  they  are  transmitted  on  noisy  com- 
munication lines,  to  provide  a  simple  error-checking  facility.  Parity  detects  all  single-bit 
errors  but  does  not  allow  error  correction  (i.e..  you  know/  that  an  error  has  occurred 
when  the  received  parity  is  wrong,  but  you  cannot  tell  which  bit  was  changed). 

LD  C.  1 00000008  saves  a  parity  bit  of  1  in  Register  C.  (Note  the  use  of  the  binary  mask: 
the  purpose  of  the  mask  is  clearer  when  it  is  specified  in  this  manner  rather  than  as  80H 
or  128  decimal.) 

The  instruction  OR  C  sets  the  parity  (most  significant)  bit  to  1  while  retaining  all  the 
other  bits  as  they  were,  as  well  as  setting  the  Z80  Parity  flag. 

The  following  procedure  is  used  to  determine  if  the  parity  of  the  byte  in  memory  is  odd 
or  even.  We  OR  a  parity  bit  into  the  byte  loaded  from  memory  and  then  test  to  see  if  the 
parity  is  odd.  If  the  parity  is  odd,  then  the  byte  in  memory  has  even  parity,  and  we  jump 
down  to  decrement  the  count  of  remaining  bytes.  If  the  parity  is  even,  then  we  know 
that  the  byte  in  memory  has  odd  parity,  and  therfore  we  store  the  byte  in  the  Ac- 
cumulator into  that  memory  location. 

The  conditional  jumps  JP  PO  (Jump  on  Parity  Odd)  and  JP  PE  (Jump  on  Parity  Even)  are 
seldom  used  except  in  parity  generation  and  checking.  Note  that  there  are  no  relative 
jumps  conditional  on  the  value  of  the  Parity  bit.  just  as  there  are  none  conditional  on 
the  value  of  the  Sign  bit. 
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Do  not  confuse  the  Parity  bit  included  in  each  character  and  the  Z80's  Parity  flag, 
which  IS  set  to  1  if  the  last  arithmetic  or  Boolean  result  had  even  parity. 

An  alternative  approach  uses  the  Z80  SET  instruction.  This  version  takes  a  little  longer 
but  does  not  require  a  temporary  register  for  the  parity  bit 

Source  Program: 


SETPR: 


CHCNT: 


LD 

HL40H 

LD 

B,(HU 

INC 

HL 

LD 

-A,(HL) 

OR 

A 

JP 

PE.CHCNT 

SET 

7,(HU 

DJNZ 

SETPR 

HALT 

:GET  STRING  LENGTH 
:GET  A  CHARACTER 

:DOES  CHARACTER  HAVE  EVEN  PARITY? 
:N0,  SET  PARITY  BIT  TO  1 


Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

46 

LD 

B.{HL) 

0004 

23 

SETPR: 

INC 

HL 

0005 

7E 

LD 

A.{HL) 

0006 

87 

OR 

A 

0007 

EA 

JP 

PE.CHCNT 

0008 

OC 

0009 

00 

OOOA 

CB 

SET 

7,(HL) 

OOOB 

FE 

OOOC 

10 

CHCNT: 

DJNZ 

SETPR 

GOOD 

F6 

OOOE 

76 

HALT 

Pattern  Match 

Purpose;  Compare  two  strings  of  ASCII  characters  to  see  if  they  are  the  same.  The 
length  of  the  strings  is  in  memory  location  0041 ,  one  string  starts  in  memory 
location  0042  and  the  other  in  memory  location  0052.  If  the  two  stnngs 
match,  clear  memory  location  0040:  otherwise,  set  memory  location  0040  to 
FF  hex  (all  ones). 

Sample  Problems: 


(0041)  = 

=  03 

(0042)  = 

=  43 

■c 

(0043)  = 

=  41 

•A' 

(0044)  = 

=  54 

T' 

(0052)  = 

=  43 

■c 

(0053)  = 

=  41 

■A' 

(0054)  = 

=  54 

'T' 

Result:   (0040)  = 

=  00, 

sir 

since  the  two  strings  are  the  same. 
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b. 


(0041)   =  03 


(0042)  =  52  'R' 

(0043)  =  41  'A' 

(0044)  =  54  T' 

(0052)  =  43  'C 

(0053)  =  41  'A- 

(0054)  =  54  T 

Result:   (0040)   =  FF,    since  the  first  characters  in  the 
strings  differ. 

Note:  The  nnatching  process  ends  as  soon  as  the  CPU  finds  a  difference  —  the  rest  of 
the  strings  need  not  be  examined. 

Flowchart: 
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Source  Program: 


LD 

HL,41H 

LD 

B,(HL) 

COUNT  =  LENGTH  OF  STRINGS 

INC 

HL 

POINTER  1  =  START  OF  STRING  1 

LD 

DE,52H 

POINTER  2  =  START  OF  STRING  2 

LD 

C.OFFH 

MARK  =  FF  (HEX) 

CHCAR:  LD 

A.(DE) 

GET  CHARACTER  FROM  STRING  2 

CP 

(HU 

IS  THERE  A  MATCH? 

JR 

NZ.DONE 

NO,  DONE 

INC 

DE 

INC 

HL 

DJNZ 

CHCAR 

CHECK  NEXT  PAIR  IF  ANY  LEFT 

LD 

CO 

MARK  =  0  IF  ALL  CHARACTERS  MATCH 

DONE:  LD 

A,C 

LD 

(40H),A 

SAVE  MARK 

HALT 

Object  Program: 

Memory  Address      Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

21 

LD 

HL,41H 

0001 

41 

0002 

00 

0003 

46 

LD 

B,(HL) 

0004 

23 

INC 

HL 

0005 

11 

LD 

DE52H 

0006 

52 

0007 

00 

0008 

OE 

LD 

COFFH 

0009 

FF 

OOOA 

1A  CHCAR: 

LD 

A,(DE) 

OOOB 

BE 

CP 

(HL) 

OOOC 

20 

JR 

NZ.DONE 

OOOD 

06 

OOOE 

13 

INC 

DE 

OOOF 

23 

INC 

HL 

0010 

10 

DJNZ 

CHCAR 

oon 

F8 

0012 

OE 

LD 

CO 

0013 

00 

0014 

79  DONE: 

LD 

A.C 

0015 

32 

LD 

(40H),A 

0016 

40 

0017 

00 

0018 

76 

HALT 

Matching  strings  of  ASCII  characters  is  an  essential  part  of  looking  for  commands, 
recognizing  names,  identifying  variables  or  operation  codes  in  assemblers  and  com- 
pilers, finding  files,  and  many  other  tasks. 


The  program  uses  two  pointers,  one  in  Register  Pair  HL  and  the  other  in  Register  Pair 
DE.  The  only  instructions  that  use  the  address  in  DE  are  LD  A,(DE)  (Load  Accumulator 
From  Memory  Location  Addressed  by  DE)  and  LD  (DE),A  (Store  Accumulator  in  Memory 
Location  Addressed  by  DE).  Arithmetic  and  logical  operations  with  memory  and 
transfers  to  or  from  other  registers  (e.g.,  ADD  A,(HL):  AND  (HL);  LD  B,(HL);  LD  (HU,E) 
can  only  be  performed  using  the  address  in  Register  Pair  HL,  or  using  an  index  register. 
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The  order  of  operations  is  very  important  because  of  the  small  number  of  instructions 
that  use  the  address  in  Register  Pair  DE.  You  must  move  a  character  from  the  string 
pointed  to  by  DE  to  the  Accumulator  and  compare  it  to  a  character  in  the  string  pointed 
to  by  HL.  This  order  of  operations  is  necessary  because  the  Z80  has  no  instruction 
which  allows  a  companson  to  a  character  in  a  string  pointed  to  by  DE. 

For  example,  if  you  replaced  LD  A,!DE)  with  LD  A,(HL).  what  would  the  next  instruction 
be?  This  asymmetry  is  peculiar  to  the  Z80  and  can  cause  programming  nightmares. 

Note  that  each  iteration  updates  both  pointers. 

This  program  could  take  advantage  of  the  fact  that  a  register  is  known  to  contain  zero 
after  a  particular  conditional  jump  is  executed.  When  the  DJNZ  CHCAR  instruction  is 
executed,  if  the  branch  is  not  performed,  then  we  know  that  Register  B  contains  zero. 
Therefore,  we  can  move  Register  B  to  Register  C,  our  flag  register,  to  indicate  that  a 
match  has  been  found. 

We  could  also  use  the  Z80's  SET  and  RESET  instructions  to  handle  the  flag  if  we 
needed  to  conserve  bits  for  other  purposes. 

PROBLEMS 

1 )    Length  of  a  Teletypewriter  Message 

Purpose;  Determine  the  length  of  an  ASCII  message.  All  characters  are  7-bit  A^SCII 
with  MSB  =  0.  The  stnng  of  characters  in  which  the  message  is  embedded 
starts  in  memory  location  0041.  The  message  itself  starts  with  an  ASCII  STX 
character  (hex  02)  and  ends  with  ETX  (hex  03).  Place  the  length  of  the 
message  (the  number  of  characters  between  the  STX  and  the  ETX  but  in- 
cluding neither)  into  memory  location  0040. 

Sample  Problem: 


(0041)  = 

=  40 

(0042)  = 

=  02 

STX 

(0043)  = 

=  47 

(0044)  = 

=  4F 

■0- 

(0045)  = 

=  03 

ETX 

Result:   (0040)  = 

=  02. 

since 

the  STX  in  location  0042  and  ETX  in 
location  0045. 

2)    Find  Last  Non-Blank  Character 

Purpose:  Search  a  string  of  ASCII  characters  for  the  last  non-blank  character.  The 
string  starts  in  memory  location  0042  and  ends  with  a  carnage  return 
character  (hex  OD).  Place  the  address  of  the  last  non-blank  character  into 
memory  locations  0040  and  0041  (most  significant  bits  in  0041). 

Sample  Problems: 

a.  (0042)   =  37 

(0043)   =  OD  OR 

Result:   (0040)   =  42.    since  the  last  (and  only)  non-blank  character 
IS  in  memory  location  0042. 
(0041)   =  00 


6-19 


(0042) 

— 

41 

■A' 

(0043) 

= 

20 

SP 

(0044) 

= 

48 

■H' 

(0045) 

= 

41 

'A' 

(0046) 

54 

'T' 

(0047) 

20 

SP 

(0048) 

20 

SP 

(0049) 

OD 

CR 

Result:  (0040) 

46 

(0041) 

00 

3)   Truncate  Decimal  String  to  Integer  Form 

Purpose:  Edit  a  string  of  ASCII  decimal  characters  by  replacing  all  digits  to  the  right  of 
the  decimal  point  with  ASCII  blanks  (hex  20).  The  string  starts  in  memory 
location  0041  and  is  assumed  to  consist  entirely  of  ASCII-coded  decimal 
digits  and  a  possible  decimal  point  (hex  2E).  The  length  of  the  string  is  in 
memory  location  0040.  If  no  decimal  point  appears  in  the  string,  assume  that 
the  decimal  point  is  implicitly  at  the  far  right. 

Sample  Problems: 


(0040) 

04 

(0041) 

37 

7' 

(0042) 

2E 

(0043) 

38 

■8' 

(0044) 

31 

'V 

(0041) 

37 

■T 

(0042) 

2E 

(0043) 

20 

SP 

(0044) 

20 

SP 

(0040) 

03 

(0041) 

26 

■6' 

(0042) 

37 

■r 

(0043) 

31 

■V 

Result:  Unchanged,  as  number  is  assumed  to  be  671. 

4}   Check  Even  Parity  in  ASCII  Characters 

Purpose:  Check  even  parity  m  a  string  of  ASCII  characters.  The  length  of  the  string  is 
in  memory  location  0041,  and  the  stnng  itself  begins  in  memory  location 
0042.  If  the  parity  of  all  the  characters  in  the  string  is  correct,  clear  memory 
location  0040;  otherwise,  place  FF  hex  (all  ones)  into  memory  location  0040. 
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Sample  Problems: 


Result:   (0040)   =  00,    since  all  the  characters  have  even  parity. 


(0041 ) 

—  uo 

(0042) 

=  B1 

(0043) 

=  B2 

—  oo 

(0040) 

=  00, 

(0041) 

=  03 

(0042) 

=  B1 

(0043) 

=  86 

(0044) 

=  33 

(0040) 

=  FF 

Result:   (0040)   =  FF    since  the  character  in  memory 

location  0042  does  not  have  even  parity. 

5)    String  Comparison 

Purpose:  Compare  two  strings  of  ASCII  characters  to  see  which  is  larger  (i.e.,  which 
follows  the  other  in  'alphabetical'  ordering).  The  length  of  the  strings  is  in 
memory  location  0041 ,  one  string  starts  in  memory  location  0042  and  the 
other  in  memory  location  0052.  If  the  string  starting  in  memory  location 
0042  is  greater  than  or  equal  to  the  other  string,  clear  memory  location 
0040:  otherwise,  set  memory  location  0040  to  FF  hex  (all  ones). 

Sample  Problems: 

a.  (0041)   =  03 

(0042)  =  43  'C 

(0043)  =  41  'A' 

(0044)  =  54  'T' 

(0052)  =  42  'B' 

(0053)  =  41  'A' 

(0054)  =  54  'T' 

Result:   (0040)   =  00.    since  CAT  is  'larger  than  BAT 

b.  (0041)   =  03 

(0042)  =  43  'C 

(0043)  =  41  'A' 

(0044)  =  54  'T' 

(0052)  =  43  'C 

(0053)  =  41  'A' 

(0054)  =  54  'T' 

Result:    (0040)    =  00,    since  the  two  stnngs  are  equal. 

c.  (0041)    =  03 

(0042)  =  43  'C 

(0043)  =  41  'A' 

(0044)  =  54  'T' 

(0052)  =  43  'C 

(0053)  =  56  'U' 

(0054)  =  54  'T' 

Result:   (0040)   =  FF,    since  CUT  is  'larger'  than  CAT. 
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Chapter  7 
CODE  CONVERSION 


Code  conversion  is  a  continual  problem  in  most  microcomputer  applications.  Periph- 
erals provide  data  in  ASCII,  BCD.  or  various  special  codes.  The  system  must  convert  the 
data  into  some  standard  form  for  processing.  Output  devices  may  require  data  in  ASCII, 
BCD.  seven-segment,  or  other  codes.  Therefore,  the  system  must  convert  the  results  to 
a  suitable  form  after  the  processing  is  completed. 

There  are  several  ways  to  approach  code  conversion: 

1)  Some  conversions  can  easily  be  handled  by  algorithms  involving  arithmetic  or  logi- 
cal functions.  The  program  may,  however,  have  to  handle  some  special  cases  sepa- 
rately, 

2)  More  complex  conversions  can  be  handled  with  lookup  tables.  The  lookup  table 
method  requires  little  programming  and  is  easy  to  apply.  However,  the  table  may 
occupy  a  large  amount  of  memory  if  the  range  of  input  values  is  large, 

3)  Hardware  is  readily  available  for  some  conversion  tasks.  Typical  examples  are 
decoders  for  BCD  to  seven-segment  conversion  and  Universal  Asynchronous 
Receiver/Transmitters  (UARTs)  for  conversion  between  parallel  (ASCII)  and  serial 
(teletypewriter)  formats. 

In  most  applications,  the  program  should  do  as  much  as  possible  of  the  code  conversion 
work.  This  results  in  a  savings  in  parts  and  board  space  as  well  as  in  increased 
reliability.  Furthermore,  most  code  conversions  are  easy  to  program  and  require  little 
execution  time, 

EXAMPLES 
Hex  to  ASCII 

Purpose:  Convert  the  contents  of  memory  location  0040  to  an  ASCII  character. 
Memory  location  0040  contains  a  single  hexadecimal  digit  (the  four  most 
significant  bits  are  zero).  Store  the  ASCII  character  in  memory  location 
0041, 

Sample  Problems: 

a,  (0040)  =  OC 
Result:   (0041)  =  43  'C 

b,  (0040)  =  06 
Result:   (0041)  =  36 
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Flowchart: 


Result  = 

Data  +  ASCII  Zero 
(41)  =  Result 


CZZEIZ) 

Source  Program: 


LD 

A,(40H) 

;GET  DATA 

CP 

10 

:IS  DATA  10  OR  MORE? 

JR 

CASCZ 

ADD 

A.'A'-'9'-1 

:YES,  ADD  OFFSET  FOR  LETTERS 

ADD 

a;o' 

:ADD  OFFSET  FOR  ASCII 

LD 

(4IH),A 

;STORE  ASCII  RESULT 

HALT 

Object  Program: 


Memorv  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

GOOD 

3A 

LD 

A,{40H) 

0001 

40 

0002 

00 

0003 

FE 

CP 

10 

0004 

OA 

0005 

38 

JR 

CASCZ 

0006 

02 

0007 

C6 

ADD 

A,'A'-'9'-1 

0008 

07 

0009 

C6 

ASCZ:  ADD 

A.'O' 

OOOA 

30 

OOOB 

32 

LD 

(41 H), A 

OOOC 

41 

OOOD 

00 

OOOE 

76 

HALT 
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In  this  program,  the  basic  idea  is  to  add  ASCII  0  to  all  the  hexadecimal  digits.  This  addi- 
tion converts  the  decimal  digits  correctly;  however,  there  is  a  break  between  ASCII  9 
(39  hex)  and  ASCII  A  (41  hex)  which  must  be  considered.  This  break  must  be  added  to 
the  nondecimal  digits  A,  B.  C,  D.  E,  and  F  This  is  accomplished  by  the  ADD  A  instruc- 
tion which  adds  the  offset  'A'-'S'-I  to  the  contents  of  the  Accumulator.  Can  you  explain 
why  the  offset  is  'A'-'9'-l  ? 

Note  that  the  addition  terms  are  placed  in  the  assembly  language  program  in  .ASCII 
form  (apostrophes  surround  an  ASCII  character  or  string  of  characters).  The  offset  for 
the  letters  is  left  as  an  arithmetic  expression.  The  effort  is  to  make  the  purpose  of  the 
terms  as  clear  as  possible  in  the  assembly  language  listing.  The  extra  assembly  time  is  a 
very  small  price  to  pay  for  a  large  increase  in  clarity. 

This  routine  could  be  used  in  a  variety  of  programs;  for  example,  monitor  programs 
must  convert  hexadecimal  digits  to  ASCII  in  order  to  display  the  contents  of  memory 
locations  in  hexadecimal  on  an  ASCII  printer  or  video  display. 

Another  (quicker)  conversion  method  that  requires  no  conditional  jumps  at  all  is  the 
following  program,  described  by  Allison  in  Computer  magazine.^ 

A,(40H)         :GET  HEX  DIGIT 

; DEVELOP  EXTRA  6  AND  CARRY 


LD 
ADD 
DAA 
ADC 
DAA 
LD 

HALT 


A,90H 


A,40H 


{4IH),A 


:ADD  IN  CARRY.  ASCII  OFFSET 


;STORE  ASCII  DIGIT 


Try  this  program  on  some  digits.  Can  you  explain  why  it  works? 
Decimal  to  Seven-Segment 

Purpose:  Convert  the  contents  of  memory  location  0040  to  a  seven-segment  code  in 
memory  location  0042.  If  memory  location  0040  does  not  contain  a  single 
decimal  digit,  clear  memory  location  0042. 

Seven-segment  table:  The  following  table  can  be  used  to  convert  decimal  numbers  to 
seven-segment  code.  The  seven-segment  code  is  organized  with  the  most  significant 
bit  always  zero  followed  by  the  code  (1  =  on,  0  =  off)  for  segments  g,  f,  e,  d,  c,  b,  and  a 
(see  Figure  7-1). 


Digit 

Code 

0 

3F 

1 

06 

2 

5B 

3 

4F 

4 

66 

5 

6D 

6 

7D 

7 

07 

8 

7F 

9 

6F 

Figure  7-1.  Seven-segment  Arrangement 
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Note  that  the  table  uses  7D  for  6  rather  than  the  alternative  7C  (top  bar  off)  to  avoid 
confusion  with  lov/er  case  b.  and  6F  for  9  rather  than  67  (bottom  bar  off),  for  no  particu- 
lar reason. 

Sample  Problems: 

a.  (0040)  =  03 
Result:   (0042)  =  4F 

b.  (0040)  =  28 
Result:    (0042)  =  00 

Flowchart: 


Note  that  the  addition  of  base  address  SSEG  and  index  (DATA)  produces  the  address 
that  contains  the  answer. 
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Source  Program: 


DONE; 
SSEG: 


LD 

B,0 

LD 

A,(4UH) 

CP 

10 

JR 

NCDONE 

LD 

L,A 

LD 

H.O 

LD 

DE.SSEG 

ADD 

HL.DE 

LD 

B,(HL) 

LD 

A.B 

LD 

(42  H),  A 

HALT 

ORG 

20  H 

DEFB 

3FH 

DEFB 

06H 

DEFB 

5BH 

DEFB 

4FH 

DEFB 

66H 

DEFB 

6DH 

DEFB 

7DH 

DEFB 

07H 

DEFB 

7FH 

DEFB 

6FH 

GET  ERROR  CODE  TO  BLANK  DISPLAY 
;GET  DATA 

IS  DATA  A  DECIMAL  DIGIT? 

;N0,  KEEP  ERROR  CODE 

:YES,  MAKE  DATA  INTO  A  16-BIT  INDEX 

:GET  BASE  ADDRESS  OF  7-SEGMENT  TABLE 
:FIND  ELEMENT  BY  INDEXING 
;GET  7-SEGMENT  CODE  FROM  TABLE 
:SAVE  7-SEGMENT  CODE  OR  ERROR  CODE 


;SEVEN-SEGMENT  CODE  TABLE 
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Object  Program: 


Memory  Address 

Memorv  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

06 

LD 

8,0 

0001 

00 

0002 

3A 

LD 

A,{40HI 

Anno 
UUUo 

4U 

UUU4 

AA 

uu 

UUUo 

rt 

CP 

10 

UUUD 

UA 

uuu/ 

QA 
OU 

JR 

NCDONE 

UUUo 

Uo 

nnno 
uuuy 

or 

LD 

LA 

nnn  A 

UUUA 

ZD 

LD 

H.O 

nnnn 

UUUD 

uu 

UUUL- 

1 1 

LD 

DE.SSEG 

nnnn 
uuuu 

on 
zu 

OOOE 

00 

OOOF 

19 

Ann 

Ml  nP 

0010 

46 

t  n 

LU 

D,\nL/ 

0011 

78 

DONE: 

1  n 

LU 

A  R 

0012 

32 

1  n 

LU 

0013 

42 

0014 

00 

0015 

76 

U  A  1  T 

HALI 

UUzU 

3F 

SSEG: 

DEFB 

3FH 

UUid  1 

Uo 

DEFB 

06H 

0022 

5B 

DEFB 

5BH 

0023 

4F 

DEFB 

4FH 

0024 

66 

DEFB 

66H 

0025 

60 

DEFB 

6DH 

0026 

7D 

DEFB 

7DH 

0027 

07 

DEFB 

07H 

0028 

7F 

DEFB 

7FH 

0029 

6F 

DEFB 

6FH 

The  program  calculates  the  memory  address  of  the  desired  code  by  adding  the  index 
(i.e..  the  digit  to  be  displayed)  to  the  base  address  of  the  seven-segment  code  table. 
This  procedure  is  known  as  a  table  lookup. 


The  assembly  language  pseudo-operation  DEFB  (Define  Byte)  places  constant  data  into 
program  memory.  Such  data  may  include  tables,  headings,  error  messages,  priming 
messages,  format  characters,  thresholds,  etc.  The  label  attached  to  a  DEFB  pseudo- 
operation  IS  assigned  the  value  of  the  address  into  vi/hich  the  byte  of  data  is  placed. 

Tables  are  often  used  to  perform  code  conversions  that  are  more  complex  than  the  pre- 
vious example.  Such  tables  typically  contain  all  the  results  organized  according  to  the 
input  data,  e.g..  the  first  entry  is  the  code  corresponding  to  the  number  zero. 

Seven-segment  displays  provide  recognizable  forms  of  the  decimal  digits  and  a  few  let- 
ters and  other  characters.  Calculator-type  seven-segment  displays  are  inexpensive, 
easy  to  combine,  and  use  little  power.  However,  the  seven-segment  coded  digits  are 
somewhat  difficult  to  read. 

The  assembler  simply  places  the  data  for  the  table  into  memory.  Note  that  one  DEFB 
pseudo-operation  fills  one  byte  of  memory.  We  have  left  some  memory  space  between 
the  program  and  the  table  to  allow  for  later  additions  or  corrections. 


7-6 


USE  OF  280 

INDEX 

REGISTERS 


An  alternative  approach  would  be  to  use  one  of  the  Z80's  index 
registers,  say  IX.  The  programmer  must  be  aware  of  the  following 
features  of  the  ZSO's  index  registers: 

1)  The  fixed  offset  in  program  memory  is  only  eight  bits  long  and 

so  cannot  hold  a  complete  memory  address.  It  must  be  used  either  as  a  short  dis- 
placement or  to  hold  the  eight  least  significant  bits  of  a  memory  address. 

2)  The  index  registers  are  16  bits  long.  Either  IX  or  lY  can  be  loaded  from  memory  |ust 
like  a  register  pair  —  from  two  consecutive  memory  addresses  with  the  least  sig- 
nificant eight  bits  at  the  lower  address. 

3)  All  operations  involving  the  index  registers  take  extra  time  and  memory  because 
one  word  of  the  operation  code  simply  declares  that  an  index  register  is  to  be  used. 

The  following  program  uses  Register  IX  to  perform  the  table  lookup: 

Source  Program: 


DONE. 


LD 

B.O 

GET  ERROR  CODE  TO  BLANK  DISPLAY 

LD 

A.(40H) 

GET  DATA 

CP 

10 

IS  DATA  A  DECIMAL  DIGIT? 

JR 

NC.DONE 

NO,  KEEP  ERROR  CODE 

LD 

HL,41H 

SAVE  TABLE  PAGE  NUMBER  IN  MEMORY 

LD 

(HLl.O 

LD 

IX.(40H) 

GET  TABLE  OFFSET 

LD 

B.dX-fSSEG) 

GET  7-SEGMENT  CODE  FROM  TABLE 

LD 

A,B 

SAVE  7-SEGMENT  CODE  OR  ERROR  CODE 

LD 

i42H),A 

HALT 

Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

06 

LD 

B.O 

0001 

00 

0002 

3A 

LD 

A,(40H) 

0003 

40 

0004 

00 

0005 

FE 

CP 

10 

0006 

OA 

0007 

30 

JR 

NCDONE 

0008 

OC 

0009 

21 

LD 

HL,41H 

OOOA 

41 

OOOB 

00 

OOOC 

36 

LD 

(HU.O 

OOOD 

00 

OOOE 

DD 

LD 

IX,{40H) 

OOOF 

2A 

0010 

40 

0011 

00 

0012 

DD 

LD 

B.fiX-FSSEG) 

0013 

46 

0014 

20 

0015 

78 

DONE. 

LD 

A.B 

0016 

32 

LD 

(42H),A 

0017 

42 

0018 

00 

0019 

76 

HALT 
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The  indexed  load  instruction  LD  B,(IX  +  SSEG)  adds  the  index  (i.e..  the  digit  to  be  dis- 
played) to  the  base  of  the  seven-segment  table  to  get  the  address  of  the  desired  code. 
Note  that  the  16-bit  index  register  contains  the  data  as  its  eight  least  significant  bits 
and  the  most  significant  bits  of  the  starting  address  of  the  table  as  its  eight  most  signifi- 
cant bits.  This  odd  arrangement  is  necessary  because  the  offset  included  with  the  in- 
dexed instruction  is  only  eight  bits  long  and  can  therefore  hold  only  the  eight  least  sig- 
nificant bits  of  the  starting  address  of  the  table. 

A  more  general  program  would  allow  the  table  to  be  placed  anywhere  in  memory.  If  the 
table  starting  address  is  SSEGM  teight  MSBs)  and  SSEGL  (eight  LSBsj.  the  instruction 
LD  (HU.O  must  be  replaced  by  LD  (HLl, SSEGM.  Why  is  this  change  necessary? 

Note  that  all  operations  involving  Index  Register  IX  have  a  2-word  operation  code  in 
which  the  first  word  is  DD. 


MOVING  DATA 

WITHIN 

A  BLOCK 


Clearly  this  is  not  a  very  efficient  use  of  the  index  registers.  These 
registers  really  become  useful  when  you  must  access  several  data 
in  a  block.  The  block  might  contain  the  characteristics  of  a 
message,  the  parameters  of  an  equation,  the  current  state  of  a  pro- 
cess or  machine,  or  the  data  for  a  video  display.  You  could,  for  example,  take  the  con- 
tents of  the  twelfth  location  in  the  block  and  move  them  to  the  twentieth  location  with 
either  of  the  following  programs,  assuming  that  the  starting  address  of  the  block  is 
stored  in  memory  locations  PTR  and  PTR+1. 

1! 

;GET  STARTING  ADDRESS 
.CALCULATE  SOURCE  ADDRESS 

;GET  DATA  FROM  SOURCE 
iCALCULATE  DESTINATION  ADDRESS 

:MOVE  DATA  TO  DESTINATION 


2)    Using  IX. 


DE  and  HL. 

LD 

DE,{PTR) 

LD 

HL,12 

ADD 

HLDE 

LD 

A,(HL) 

LD 

HL,20 

ADD 

HLDE 

LD 

(HU.A 

IX. 

LD 

IX,  (PTR) 

LD 

A,(IX-I-12) 

LD 

(IX-F20),A 

;GET  STARTING  ADDRESS 
:GET  DATA  FROM  SOURCE 
:MOVE  DATA  TO  DESTINATION 


The  program  using  the  index  registers  is  far  shorter  and  clearer  Its  only  limitation  is 
that  the  offsets  must  be  small  enough  to  fit  into  an  8-bit  byte. 

ASCII  to  Decimal 

Purpose:  Convert  the  contents  of  memory  location  0040  from  an  ASCII  character  to  a 
decimal  digit  and  store  the  result  in  memory  location  0041.  If  the  contents  of 
memory  location  0040  are  not  the  ASCII  representation  of  a  decimal  digit, 
set  the  contents  of  memory  location  0041  to  FF  (hex). 

Sample  Problems: 

a.  (0040)  =  37  'T 
Result;   (0041)  =  07 

b.  (0040)  =  55 
Result:   (0041)  =  FF 
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Flowchart: 


Source  Program: 


LD 

B.OFFH 

GET  ERROR  MARKER 

LD 

A.(40H) 

GET  DATA 

SUB 

■Q- 

IS  DATA  BELOW  ASCII  ZERO? 

JR 

CDONE 

YES,  NOT  A  DIGIT 

CP 

■9'  +  1 

IS  DATA  ABOVE  ASCII  NINE 

JR 

NC.DONE 

YES,  NOT  A  DIGIT 

LD 

B,A 

SAVE  DIGIT  IF  VALID 

LD 

A,B 

SAVE  DIGIT  OR  ERROR  MARKER 

LD 

(41 H),  A 

HALT 
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Memorv  Address 

Memorv  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

1  0000 

06 

LD 

B.OFFH 

0001 

FF 

0002 

3A 

LD 

A,(40H) 

0003 

40 

0004 

00 

0005 

D6 

SUB 

■0' 

0006 

30 

0007 

38 

JR 

CDONE 

0008 

05 

0009 

FE 

CP 

OOOA 

3A 

OOOB 

30 

JR 

NCDONE 

OOOC 

01 

GOOD 

47 

LD 

B,A 

OOOE 

78  DONE: 

LD 

A.B 

OOOF 

32 

LD 

(41H),A 

0010 

41 

0011 

00 

0012 

76 

HALT 

This  program  handles  ASCII-coded  characters  lust  like  ordinary  numbers.  Note  that  the 
decimal  digits  and  the  letters  form  groups  of  consecutive  codes.  Strings  of  letters  (like 
names)  can  be  alphabetized  bv  placing  their  ASCII  representations  in  increasing 
numerical  order  (ASCII  B  =  ASCII  A  +  1  for  example). 


Subtracting  ASCII  zero  (30  hex)  from  anv  ASCII  decimal  digit  gives  the  BCD  represen- 
tation of  that  digit. 

ASCII  to  decimal  conversion  is  necessary  when  decimal  numbers  are  being  entered 
from  an  ASCII  device  like  a  teletypewriter  or  video  terminal. 

The  basic  idea  of  the  program  is  to  determine  if  the  character  is  between  ASCII  0  and 
ASCII  9.  inclusive.  If  the  character  is,  it's  an  ASCII  decimal  digit,  since  the  digits  form  a 
sequence.  It  may  then  be  converted  to  decimal  simply  by  subtracting  hex  30  (ASCII  0), 
e.g.,  ASCII  7  -  ASCII  0  =  37-30  =  7 

Note  that  one  comparison  is  done  with  an  actual  subtraction  (SUB  'O'j  since  the  subrac- 
tion  is  necessary  to  convert  ASCII  to  decimal.  The  other  comparison  is  done  with  an  im- 
plied subtraction  (CP  '9'-t-1)  since  the  final  result  is  now  in  the  Accumulator  if  the  origi- 
nal number  was  valid. 

BCD  to  Binary 

Purpose:  Convert  two  BCD  digits  in  memorv  locations  0040  and  0041  to  a  binary 
number  in  memory  location  0042.  The  most  significant  BCD  digit  is  in 
memory  location  0040. 

Sample  Problems: 

a.  (0040)   =  02 
(0041)   =  09 

Result;  (0042)  =  ID  (hex)  =  29  (decimal) 

b.  (0040)   =  07 
(0041)   =  01 

Result;   (0042)   =  47  (hex)  =  71  (decimal) 


7-10 


Note:  No  flowchart  is  included  since  the  progrann  multiplies  the  most  significant  digit 
by  10  simply  by  using  the  formula  lOx  =  8x  +  2x.  Multiplying  by  2  requires  one 
arithmetic  left  shift  and  multiplying  by  8  requires  three  such  shifts. 


Source  Program: 


LD  HL,4uH 

GET  MOST  SIGNIFICANT  DIGIT  (MSD) 

LD           A  (HL! 

ADD  A,A 

MSD  TIMES  TWO 

LD  B.A 

SAVE  MSD  TIMES  TWO 

ADD  A.A 

MSD  TIMES  FOUR 

ADD  A.A 

MSD  TIMES  EIGHT 

ADD  A,B 

MSD  TIMES  TEN 

INC  HL 

POINT  TO  LEAST  SIGNIFICANT  DIGIT 

ADD  A,(HL) 

ADD  TO  FORM  BINARY  EQUIVALENT 

INC  HL 

LD  (HL),A 

STORE  BINARY  EQUIVALENT 

HALT 

Object  Program: 

Memory  Address      Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

7E 

LD 

A,(HU 

0004 

87 

ADD 

A.A 

0005 

47 

LD 

B.A 

0006 

87 

ADD 

A.A 

0007 

87 

ADD 

A.A 

0008 

80 

ADD 

A.B 

0009 

23 

INC 

HL 

OOOA 

86 

ADD 

A,(HL) 

OOOB 

23 

INC 

HL 

OOOC 

77 

LD 

(HU.A 

OOOD 

76 

HALT 

BCD  entries  are  converted  to  binary  in  order  to  save  on  storage  and  to  simplify  calcula- 

tions. However,  the  conversion  may  offset  some  of  the  advantages  of  binary  storage 

and  arithmetic. 

This  program  multiplies  the  BCD  digit  in  memory  location  0040  by  ten  using  repeated 
additions.2  Note  that  ADD  A.A  multiplies  the  contents  of  the  Accumulator  by  2.  This 
allows  you  to  multiply  the  contents  of  the  Accumulator  by  small  decimal  numbers  in  a 
few  instructions.  How  would  you  use  this  procedure  to  multiply  by  16?  by  12?  by  7? 

BCD  numbers  require  about  20%  more  storage  than  do  binary  numbers.  Representing  0 
to  999  requires  12  bits  in  BCD  form  but  only  10  bits  in  binary  (since 
2l0  =  1024  =  1000). 

Convert  Binary  Number  to  ASCII  String 

Purpose:  Convert  the  8-bit  binary  number  in  memory  location  0041  to  eight  ASCII 
characters  (either  ASCII  0  or  ASCII  1)  in  memory  locations  0042  through 
0049  (the  most  significant  bit  is  in  0042). 
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Sample  Problem: 


(0041) 

=  D2  = 

=  1 

Qaci  1  If  tCiCiA'?) 

nesuil- 

=  31 

'  1 ' 

(0043) 

=  31 

■r 

(0044) 

=  30 

■0' 

(0045) 

=  31 

■r 

(0046) 

=  30 

■0- 

(0047) 

=  30 

■0' 

(0048) 

=  31 

■r 

(0049) 

=  30 

'O' 

11010010 


Flowchart: 


c 


I  Pointer  =  41 

I     Data  =  (Painter) 

I  Counter  =  8 


Pointer  =  Pointer  H 
(Pointer)  =  ASCII  0 
Shift  Data  left  one  bit 


(Pointer)  = 
ASCII  1,  i.e., 
(Pointer)  +  1 


Source  Program: 


CONV; 


COUNT. 


LD 

HL,41H 

LD 

A,(HU 

LD 

B,8 

LD 

CV 

INC 

HL 

LD 

(HU.C 

RLA 

JR 

NC.COUNT 

INC 

(HU 

DJNZ 

CONV 

HALT 

;GET  DATA 

.COUNTER  =  NUMBER  OF  BITS  IN  WORD 
■.GET  ASCII  ZERO  TO  STORE  IN  STRING 

PUT  ASCII  ZERO  IN  STRING 

IS  NEXT  BIT  OF  DATA  1  ? 

YES,  MAKE  STRING  ELEMENT  ASCII  ONE 
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Object  Program: 


Mernory  Address 

tviSmorv  contents 

Instruction 

\nBX} 

\nex; 

(Mnemonic) 

0000 

21 

LU 

LJ!    /I  1  U 

0001 

41 

0002 

00 

0003 

7E 

LU 

M,\nL/ 

0004 

06 

LU 

D,o 

0005 

08 

0006 

OE 

LU 

L..  U 

0007 

30 

0008 

23 

"CONV: 

INC 

HL 

0009 

71 

LD 

(HU.C 

OOOA 

1 7 

RLA 

OOOB 

30 

JR 

NC.COUNT 

OOOC 

01 

OOOD 

34 

INC 

(HL) 

OOOE 

10 

COUNT: 

DJNZ 

CONV 

OOOF 

F8 

0010 

76 

HALT 

The  ASCII  digits  form  a  sequence  so  ASCII  1  =  ASCII  0+1.  Remember  that  the  Z80 
registers  have  special  uses.  You  should  place  the  loop  counter  into  Register  B  so  that 
you  can  use  the  DJNZ  instruction. 


Be  careful  of  the  difference  between  INC  HL,  which  adds  one  to  the  16-bit  contents  of 
Register  Pair  HL,  and  INC  (HL),  which  adds  one  to  the  8-bit  contents  of  the  memory 
location  addressed  by  Register  Pair  HL. 

Binary-to-ASCII  conversion  is  necessary  when  numbers  are  printed  in  binary  form  on  an 
ASCII  device. 

The  conversion  to  ASCII  simply  involves  adding  ASCII  0  (hex  30). 

PROBLEMS 

1)  ASCII  to  Hex 

Purpose:  Convert  the  contents  of  memory  location  0040  to  a  hexadecimal  digit  and 
store  the  result  in  memory  location  0041.  Assume  that  memory  location 
0040  contains  the  ASCII  representation  of  a  hexadecimal  digit  (7  bits  with 
MSB  0). 

Sample  Problems: 

a.  (0040)  =  43  'C 
Result;  (0041)  =  OC 

b.  (0040)  =  36  'e' 
Result:   (0041)  =  06 

2)  Seven-Segment  to  Decimal 

Purpose:  Convert  the  contents  of  memory  location  0U40  from  a  seven-segment  code 
to  a  decimal  number  in  memory  location  0041 .  If  memory  location  0040  does 
not  contain  a  valid  seven-segment  code,  set  memory  location  0041  to  FF 
(hex).  Use  the  seven-segment  table  given  under  the  Decimal  to  Seven-Seg- 
ment example  and  try  to  match  codes. 
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Sample  Problems: 

a.  (0040)   =  4F 
Result:   (0041)    =  03 

b.  (0040)   =  28 
Result;   (0041)   =  FF 

3)  Decimal  to  ASCII 

Purpose:  Convert  the  contents  of  memorv  location  0040  fronn  a  decimal  digit  to  an 
ASCII  character  and  store  the  result  in  memorv  location  0041.  If  the  number 
m  memorv  location  0040  is  not  a  decimal  digit,  set  the  contents  of  memon/ 
location  0041  to  an  ASCII  blank  character  (20  hex). 

Sample  Problems: 

a.  (0040)    =  07 
Result:    (0041)    =  37  'T 

b.  '  (0040)    =  55 
Result:   (0041)    =  20  SP 

4)  Binary  to  BCD 

Purpose:  Convert  the  contents  of  memory  location  0040  to  two  BCD  digits  in  memory 
locations  0041  and  0042  (most  significant  digit  in  0041).  The  number  in 
memory  location  0040  is  unsigned  and  less  than  100. 

Sample  Problems: 


a. 

(0040) 

=  ID 

(29  decima 

Result: 

(0041) 
(0042) 

=  02 
=  09 

b. 

(0040) 

=  47 

(71  decimal 

Result: 

(0041) 
(0042) 

=  07 
=  01 

5}    ASCII  String  to  Binary  Number 

Purpose:  Convert  the  eight  ASCII  characters  in  memory  locations  0042  through  0049 
to  an  8-bit  binary  number  in  memory  location  0041  (the  most  significant  bit 
IS  in  0042).  Clear  memop/  location  0040  if  ail  the  ASCII  characters  are  either 
ASCII  1  or  ASCII  0  and  set  it  to  FF  otherw^ise. 

Sample  Problems: 


(0042) 

=  31 

■r 

(0043) 

=  31 

■r 

(0044) 

=  30 

■0' 

(0045) 

=  31 

■r 

(0046) 

=  30 

■O' 

(0047) 

=  30 

■0' 

(0048) 

=  31 

■y 

(0049) 

=  30 

■0' 

Result:  (0041) 

=  D2 

(0040) 

=  00 

b.  same  as  a'  except: 

(0045)   =  37 

Result:    (0040)    =  FF 
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Chapter  8 
ARITHIVIETiC  PROBLEMS 


Most  arithmetic  in  microprocessor  applications  consists  of  multiple-word  binary  or 
decimal  manipulations.  A  decimal  correction  (decimal  adjust)  or  some  other  means  for 
performing  decimal  arithmetic  is  frequently  the  only  arithmetic  instruction  provided 
besides  basic  addition  and  subtraction.  You  must  implement  other  arithmetic  opera- 
tions with  sequences  of  instructions. 

Multiple-precision  binary  arithmetic  requires  simple  repetitions  of  the  basic  single-word 
instructions.  The  Carry  bit  transfers  information  between  words.  Add  with  Carry  and 
Subtract  with  Carry  use  the  information  from  the  previous  arithmetic  operations.  You 
must  be  careful  to  clear  the  Carry  before  operating  on  the  first  words  (obviously  there  is 
no  carry  into  or  borrow  from  the  least  significant  bits). 

Decimal  arithmetic  is  a  common  enough  task  for  microprocessors  that  most  have 
special  instructions  for  this  purpose.  These  instructions  may  either  perform  decimal 
operations  directly  or  correct  the  results  of  binary  operations  to  the  proper  decimal 
form.  Decimal  arithmetic  is  essential  in  such  applications  as  point-of-sale  terminals, 
calculators,  check  processors,  order  entry  systems,  and  banking  terminals. 

You  can  implement  multiplication  and  division  as  series  of  additions  and  subtractions 
respectively,  much  as  they  are  done  by  hand.  Double-word  operations  are  necessary 
since  a  multiplication  produces  a  result  twice  as  long  as  the  operands,  while  a  division 
similarly  contracts  the  length  of  the  result.  Multiplications  and  divisions  are  time-con- 
suming when  done  in  software  because  of  the  repeated  arithmetic  and  shift  operations 
that  are  necessary.  Of  course,  multiplying  or  dividing  by  a  power  of  2  is  simple  because 
such  operations  can  be  implemented  with  an  appropriate  number  of  left  or  right 
arithmetic  shifts. 

EXAMPLES 

Multiple-Precision  Addition 

Purpose:  Add  two  multiple-word  binary  numbers.  The  length  of  the  numbers  (in  bytes) 
is  in  memory  location  0040,  the  numbers  themselves  start  (least  significant 
bits  first)  in  memory  locations  0041  and  0051,  respectively,  and  the  sum 
replaces  the  number  starting  in  memory  location  0041. 
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Sample  Problem: 


(0040) 

— 

04 

(0041) 

C3 

(0042) 

A7 

(00431 

5B 

(0044) 

2F 

(0051) 

B8 

(0052) 

35 

(0053) 

DF 

(0041) 

7B 

(0042) 

DD 

(0043) 

3A 

(0044) 

44 

2F5BA7C3 

+ 

14DF35B8 

443ADD7B 

Flowchart: 
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Source  Program: 


LD 

HL.40H 

COUNT  =  LENGTH  OF  STRINGS  (IN  BYTES) 

LD 

B,(HL) 

INC 

HL 

POINTER  1  =  FIRST  WORD  OF  STRING  1 

LD 

DE,51  H 

POINTER  2  =  FIRST  WORD  OF  STRING  2 

AND 

/\ 

CI  EAR  CARRY  TO  START 

ADDW:  LD 

A,(DE) 

GET  WORD  FROM  STRING  2 

ADC 

A,(HL) 

ADD  WORD  FROM  STRING  1 

LD 

(HU.A 

STORE  RESULT  IN  STRING  1 

iNC 

DE 

INC 

HL 

DJNZ 

ADDW 

HALT 

Object  Program: 


Memorv  Address 
(Hex) 

Memory  Contents 
(Hex) 

instruction 
(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

46 

LD 

B,(HL) 

0004 

23 

INC 

HL 

0005 

11 

LD 

DE,51H 

0006 

51 

0007 

00 

0008 

A7 

AND 

A 

0009 

lA 

ADDW:  LD 

A,(DE) 

OOOA 

8E 

ADC 

A,(HL) 

OOOB 

77 

LD 

(HU.A 

OOOC 

13 

INC 

DE 

OOOD 

23 

INC 

HL 

OOOE 

10 

DJNZ 

ADDW 

OOOF 

F9 

0010 

76 

HALT 

The  relative  address  for  DJNZ  ADDW  is: 

09  09 
-10  =  +F0 
F9 

The  instruction  AND  A  is  used  to  clear  the  Carry  bit.  Any  other  logical  operation  would 
have  the  same  effect.  The  Carry  must  be  cleared,  since  there  is  no  carry  involved  in  the 
addition  of  the  least  significant  bytes. 

The  instruction  ADC,  Add  with  Carry,  includes  the  Carry  from  the  previous  words  in  the 
addition.  ADC  is  the  only  instruction  m  the  loop  that  affects  the  Carry  Remember  that 
neither  INC  nor  DJNZ  does. 

Both  the  pointer  in  Register  Pair  DE  and  the  one  in  HL  must  be  updated  during  each 
Iteration. 
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This  procedure  can  add  binary  numbers  of  up  to  256  bytes  in 
length.  Note  that  the  ten  binary  bits  correspond  to  three  decimal 
digits,  since  2^0  =  1024  =  1000.  So,  you  can  calculate  the  num- 
ber of  bits  required  to  give  a  certain  accuracy  in  decimal  digits.  For 
example,  ten  decimal  digit  accuracy  requires; 


DECIMAL 
ACCURACY 
IN  BINARY 


(10  digits) 


/ 10  bits  \ 
\3  digits/ 


33  bits 


If  we  were  only  transferring  the  data  from  one  place  in  memory  BLOCK 
to  another  and  not  also  processing  it,  we  could  use  the  ZSO's  TRANSFER 
powerful  block  transfer  instruction  LDIR.  This  single  instruction  INSTRUCTIONS 
moves  a  byte  of  data  from  the  address  in  HL  to  the  address  in 

DE,  increments  the  pointers  in  HL  and  DE,  and  decrements  the  byte  counter  in  BC.  It 
repeats  the  move  operation  until  BC  is  decremented  to  zero.  LDI  is  the  same  instruction 
without  the  repetition  factor;  LDD  and  LDDR  are  non-repeated  and  repeated  moves, 
respectively,  that  decrement  the  pointers  rather  than  incrementing  them. 

A  program  to  transfer  a  fixed  number  of  bytes  (LENGTH)  from  one  place  in  memory 
(starting  at  PTR1)  to  another  place  in  memory  (starting  at  PTR2)  is  the  following. 

Block  Move 

Purpose;  Move  a  block  of  data  BC  characters  long  from  the  address  in  HL  to  the  ad- 
dress in  DE. 

Sample  Problem: 


(HL) 

40 

(DE) 

50 

(BC) 

3 

(0040) 

31 

(0041) 

32 

(0042) 

33 

(0050) 

0 

(0051) 

0 

(0052) 

0 

(0050) 

31 

(0051) 

32 

(0052) 

33 

Source  Program: 

LD 
LD 
LD 

LDIR 
HALT 


BC.LENGTH 

HUPTRI 

DE,PTR2 


;COUNT  =  LENGTH  OF  TRANSFER  (IN  BYTES) 
;POINTER  1  =  START  OF  DATA  SOURCE  AREA 
;POINTER  2  =  START  OF  DATA  DESTINATION 
;  AREA 
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Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

01 

0001 

0002 

0003 

21 

1  n                 1-^1  PTR1 

i-u             ni_,r  1  n  1 

0004 

PTR1 

0006 

11 

LD  DE,PTR2 

0007 

0008 

PTR2 

0009 

ED 

LDIR 

OOOA 

BO 

OOOB 

76 

HALT 

Try  to  implement  the  same  program  without  the  LDIR  instruction.  How  many  bytes  of 
memory  and  clock  cycles  does  it  require  each  way? 

Decimal  Addition 

Purpose;  Add  two  multiple-word  decimal  (BCD)  numbers.  The  length  of  the  numbers 

is  in  memory  location  0040,  the  numbers  themselves  start  (least  significant 
bits  first)  in  memory  locations  0041  and  0051,  respectiyely,  and  the  sum 
replaces  the  number  starting  in  memory  location  0041. 


Sample  Problem: 


(0040) 

04 

(0041) 

85 

(0042) 

19 

(0043) 

70 

(0044) 

36 

(0051) 

59 

(0052) 

34 

(0053) 

66 

(0054) 

12 

(0041) 

44 

(0042) 

54 

(0043) 

36 

(0044) 

49 

that  is,  36701985 
+12663459 
49365444 
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Flowchart; 


Source  Program 

LD 
LD 
INC 
LD 
AND 
DEC  AD:  LD 
ADC 
DAA 
LD 
INC 
INC 
DJNZ 
HALT 


CIEZ) 


Count 

=  (40) 

Pointer  1 

=  41 

Pointer  2 

=  51 

Carry 

=  0 

(Pointer  1)  = 

{Pointer  1) 
(Pointer  2) 
Carry  + 
Decimal  correction 


(This  step  also  produces  a  new  Carry) 


I  Pointer  1  = 
I  Pointer  1  +  1 

I  Pointer  2  = 
I  Pointer  2  +  1 

1  Count    =  Count 


HL40H 

B,(HL)  ;COUNT  =  LENGTH  OF  STRINGS  (IN  BYTES) 

HL  ;POINTER  1  =  FIRST  WORD  OF  STRING  1 

DE,51  H  :POINTER  2  =  FIRST  WORD  OF  STRING  2 

A  ;CLEAR  CARRY  TO  START 

A,(DEi  ;GET  2  DECIMAL  DIGITS  FROM  STRING  2 

A.(HL)  :ADD  PAIR  OF  DIGITS  FROM  STRING  1 

:MAKE  ADDITION  DECIMAL 

(HU.A  :STORE  RESULT  IN  STRING  1 
DE 
HL 

DECAD 
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Object  Program: 


tvicniuty  *^uufKoo 
(Hex) 

(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL.40H 

0001 

40 

0002 

00 

0003 

46 

LD 

B,(HL) 

0004 

23 

INC 

HL 

0005 

11 

LD 

DE,51H 

0006 

51 

0007 

00 

0008 

A7 

AND 

A 

uuuy 

1  A 

1  A 

DECAD:  LD 

A,(DE) 

OOOA 

8E 

ADC 

A,(HL) 

OOOB 

27 

DAA 

OOOC 

77 

LD 

(HLl.A 

OOOD 

13 

INC 

DE 

OOOE 

23 

INC 

HL 

OOOF 

10 

DJNZ 

DECAD 

0010 

F8 

0011 

76 

HALT 

The  Decimal  Adjust  instruction  (DAA)  uses  the  Carry  (C)  and  Half 
Carry  (H)  bits  to  correct  the  following  situations: 

1)    The  sum  of  two  digits  is  between  10  and  15.  inclusive.  In  this 
case.  SIX  must  be  added  to  the  sum  to  give  the  right  result,  i.e. 

0101  (5) 

+  1000  (8) 

1101  (D) 
+  0110 


DECIMAL 
ADJUST 


0001  0011   (BCD  13.  which  is  correct) 

2)    The  sum  of  two  digits  is  16  or  more.  In  this  case  the  result  is  a  proper  BCD  number 
but  SIX  less  than  it  should  be.  i.e. 

1000 
+  1001 


0001  0001 
+  0110 


(8) 
(9) 

(BCD  11) 


0001  01 1 1   (BCD  17,  which  is  correct) 

Six  must  be  added  in  both  situations.  However,  case  1  can  be  recognized  by  the  fact 
that  the  sum  is  not  a  BCD  digit,  it  is  between  10  and  16  (or  A  and  F  hexadecimal).  Case 
2  can  be  recognized  only  by  the  fact  that  the  Carry  (most  significant  digit)  or  Half  Carry 
(least  significant  digit)  has  been  set  to  1 .  since  the  result  is  a  valid  BCD  number.  DAA  is 
the  only  instruction  that  uses  the  Half  Carry.  Note  that  DAA  operates  only  on  the  Ac- 
cumulator. 


The  Z80  microprocessor  also  has  a  flag  that  distinguishes  be-  ADD/SUBTRACT 

tween  Add  instructions  (ADD.  ADC)  and  Subtract  instructions  FLAG  

(SUB,  SBC).  This  flag,  called  the  Add/Subtract  flag  or  N  flag,  is 

cleared  by  all  Add  instructions  and  set  by  all  Subtract  instructions.  The  sole  use  of  this 
flag  IS  to  allow  the  DAA  instruction  to  correctly  change  binary  addition  into  BCD  addi- 
tion and  binary  subtraction  into  BCD  subtraction.  The  8080  and  8085  microprocessors 
do  not  have  an  N  flag,  and  so  their  DAA  instructions  operate  properly  only  after  addi- 
tion. 
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ACCURACY  IN 
BINARY  AND 
BCD 


DAA  can  be  used  only  after  instructions  that  place  their  result  into  the  Accumulator 
and  that  properly  affect  the  Carry,  Half-Carry,  and  Add/Subtract  flags.  Thus,  you  cannot 
use  DAA  after  INC  (since  INC  does  not  affect  the  Carry),  DEC,  or  any  of  the  double-word 
instructions  that  place  their  results  into  the  index  registers  or  Register  Pair  HL. 

This  procedure  can  add  decimal  (BCD)  numbers  of  any  length. 
Here  four  binary  bits  are  required  for  each  decimal  digit,  so  ten- 
digit  accuracy  requires: 

10x4  =  40  bits 

as  opposed  to  33  bits  in  the  binary  case.  This  is  essentially  five  8-blt  words  instead  of 
four.  The  decimal  procedure  also  takes  a  little  longer  per  word  because  of  the  extra 
DAA  instruction. 

8-Bit  Binary  Multiplication 

Purpose:  Multiply  the  8-bit  unsigned  number  in  memory  location  0040  by  the  8-bit 
unsigned  number  in  memory  location  0041 .  Place  the  eight  least  significant 
bits  of  the  result  into  memory  location  0042  and  the  eight  most  significant 
bits  into  memory  location  0043. 

Sample  Problems: 

a.  (0040)    =  03 
(0041)   =  05 

Result:  (0042)  =  OF 
(0043)   =  00 

or  in  decimal  3x5  =  15 

b.  (0040)   =  6F 
(0041)   =  61 

Result:  (0042)  =  OF 
(0043)  =  2A 
or  111  X  97  =  10.767 

You  can  perform  multiplication  on  a  computer  in  the  same  way  that  you  do  long 
multiplication  by  hand.  Since  the  numbers  are  binary,  the  only  problem  is  whether  to 
multiply  by  0  or  1;  multiplying  by  zero  obviously  gives  zero  as  a  result,  while  multiplying 
by  one  produces  the  same  number  that  you  started  with  (the  multiplicand).  So,  each 
step  in  a  binary  multiplication  can  be  reduced  to  the  following  operation. 


If  the  current  bit  in  the  multiplier  is  1,  add  the  multiplicand  MULTIPLICATION 
to  the  partial  product.  ALGORITHM 

The  only  remaining  problem  is  to  ensure  that  you  line  everything  up  correctly  each 
time.  The  following  operations  perform  this  task. 

1)  Shift  multiplier  left  one  bit  so  that  the  bit  to  be  examined  is  placed  into  the  Carry. 

2)  Shift  product  left  one  bit  so  that  the  next  addition  is  lined  up  correctly. 
The  complete  process  for  binary  multiplication  is  as  follows:^ 

Step  1  -  Initialization 
Product  =  0 
Counter  =  8 

Step  2  -  Shift  Product  so  as  to  line  up  properly 
Product  =  2  X  Product  (LSB  =  0) 

Step  3  -  Shift  Multiplier  so  bit  goes  to  Carry 
Multiplier  =  2  X  Multiplier 
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Step  4  -  Add  Multiplicand  to  Product  if  Carry  is  1 

If  Carry  =  1,  Product  =  Product  +  Multiplicand 

Step  5  -  Decrement  Counter  and  check  for  zero 
Counter  =  Counter  -  1 
If  Counter  ?^  0  go  to  Step  2 

In  the  case  of  Sample  Problem  b.  where  the  multiplier  is  61  (hex)  and  the  multiplicand  is 
6F  (hex)  the  process  works  as  follows: 

Initialization: 

Product  0000 

Multiplier  61 

Multiplicand  6F 

Counter  08 

After  first  iteration  of  steps  2-5: 

Product  0000 

Multiplier  C2 

Multiplicand  6F 

Counter  07 

Carry  from  Multiplier  0 

After  second  iteration: 

Product  006F 

Multiplier  84 

Multiplicand  6F 

Counter  06 

Carry  from  Multiplier  1 

After  third  iteration: 


Product 

014D 

Multiplier 

08 

Multiplicand 

6F 

Counter 

05 

Carry  from  Multiplier 

1 

After  fourth  iteration: 

Product  029A 

Multiplier  10 

Multiplicand  6F 

Counter  04 

Carry  from  Multiplier  0 

After  fifth  iteration: 

Product  0534 

Multiplier  20 

Multiplicand  6F 

Counter  03 

Carry  from  Multiplier  0 

After  sixth  iteration: 

Product  0A68 

Multiplier  40 

Multiplicand  6F 

Counter  02 

Carry  from  Multiplier  0 
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After  seventh  iteration: 


After  eighth 


Product 

1  Ann 

^^llit^^^ll^3^ 
fVIU  i  Ll|jllt:jl 

80 

Muttipiicand 

fip 

ur 

Count6r 

Parrv  frnm  Mtiltinlipr 

0 

Iteration: 

Product 

2A0F 

Multiplier 

00 

Multiplicand 

6F 

Counter 

00 

Carry  from  Multiplier 

1 

Flowchart: 


c 


Muitipticand  = 

(40) 

Multipiier  = 

(41) 

Product  = 

0 

Count  = 

8 

Product  =  2  X  Product! 

(Shift  left  1  bit)  I 
Multiplier  =2xMult!piier| 
(Shift  left  1  bit)  I 
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Source  Program: 

LD  HL,40H 

LD  E,(HL!  ;GET  MULTIPLICAND 

LD  D,0  :  EXTEND  TO  16  BITS 

INC  HL 

LD  A.(HL)  :GET  MULTIPLIER 

LD  HLO  :PRODUCT  =  ZERO 

LD  B.8  ;COUNT  =  BIT  LENGTH  OF  MULTIPLIER 

MULT;     ADD  HL.HL  iSHIFT  PRODUCT  LEFT  1  BIT 

RLA  :SHIFT  MULTIPLIER  LEFT  1  BIT 

JR  NC.CHCNT  :IS  CARRY  FROM  MULTIPLIER  1? 

ADD  HL.DE  :YES.  ADD  MULTIPLICAND  TO  PRODUCT 

CHCNT    DJNZ  MULT 

LD  (42H),HL  :SAVE  PRODUCT  IN  MEMORY 

HALT 

Object  Program: 

Memory  Address      Memory  Contents  Instruction 

(Hex)  (Hex)  (Mnemonic) 


0000  21  LD  HL.40H 

0001  40 

0002  00 

0003  5E  LD  E,(HL) 

0004  16  LD  D.O 

0005  00 

0006  23  INC  HL 

0007  7E  LD  A,(HL) 

0008  21  LD  HL,0 

0009  00 
OOOA  00 

OOOB  06  LD  B.8 

OOOC  08 

OOOD  29  MULT;     ADD  HL.HL 

OOOE  17  RLA 

OOOF  30  JR  NC.CHCNT 

0010  01 

0011  19  ADD  HL.DE 

0012  10  CHCNT    DJNZ  MULT 

0013  F9 

0014  22  LD  (42H),HL 

0015  42 

0016  00 

0017  76  HALT 


Note  that  the  multiplicand  must  be  extended  to  16  bits  by  clearing  Register  D  so  that  it 
can  be  added  to  the  product  using  the  ADD  HL.DE  Instruction. 

The  instruction  ADD  HL.'HL  acts  as  a  16-bit  logical  left  shift  for  the  16-bit  product. 

In  this  program,  the  Z80  16-bit  instructions  handle  data  rather  than  addresses.  LD  HLO 
is  used  to  initialize  the  product:  ADD  HL.HL  to  perform  a  16-bit  logical  left  shift;  ADD 
HL.DE  to  add  the  multiplicand  to  the  partial  product:  and  LD  (42H).HL  to  store  the 
result  in  memory.  You  must  be  careful  to  extend  8-bit  quantities  (like  the  multiplicand 
in  this  example)  to  1 6  bits.  Note  that  you  cannot  use  the  1 6-bit  facilities  simultaneously 
for  addressing  and  data  manipulation.  Howeyer.  if  you  have  no  other  heed  for  the  alter- 
nate registers,  you  could  saye  the  old  contents  of  the  regular  registers  there  and  restore 
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them  afterward  using  the  EXX  instruction.  This  instruction  exchanges  the  contents  of 
Register  Pairs  BC,  DE,  and  HL  with  the  contents  of  their  alternate  counterparts  in  |ust 
four  clock  cycles. 

Besides  its  obvious  use  in  calculators  and  point-of-sale  terminals,  multiplication  is  a  key 
part  of  almost  all  signal  processing  and  control  algorithms.  The  speed  at  which 
multiplications  can  be  performed  determines  the  usefulness  of  a  CPU  in  process  con- 
trol, signal  detection,  and  signal  analysis. 

The  algorithm  takes  between  390  and  440  clock  cycles  to  multiply  on  a  Z80 
microprocessor.  The  precise  time  depends  on  the  number  of  one  bits  in  the  multiplier. 
Other  algorithms  may  be  able  to  reduce  the  average  execution  time  somewhat,  but  400 
clock  cycles  will  still  be  a  typical  execution  time  for  a  software  multiplication. 2 

8-Bit  Binary  Division 

Purpose:  Divide  the  16-bit  unsigned  number  in  memory  locations  0040  and  0041 
(most  significant  bits  in  0041)  by  the  8-bit  unsigned  number  m  memory  loca- 
tion 0042.  The  numbers  are  normalized  so  that  1)  the  most  significant  bits  of 
both  the  dividend  and  the  divisor  are  zero  and  2)  the  number  in  memory 
location  0042  is  greater  than  the  number  in  memory  location  0041,  i.e..  the 
quotient  is  an  8-bit  number.  Store  the  quotient  in  memory  location  0043  and 
the  remainder  in  location  0044. 

Sample  Problems: 

a.  (0040)    =  40  (64  decimal) 

(0041)  =  00 

(0042)  =  08 

Result  =  (0043)  =08 
(0044)  =  00 
I.e.,  64/8  =  8 

b.  (0040)   =  6D  (12,909  decimal) 

(0041)  =  32 

(0042)  =  47  (71  decimal) 

Result   =  (0043)  =  85  (181  decimal) 
(0044)  =  3A  (58  decimal) 
I.e.,  12,909/71  =  181  with  a  remainder  of  58 


You  can  perform  division  on  the  computer  |ust  like  you  would  per-      j  DIVISION 
form  division  with  pen  and  paper,  i.e.,  using  trial  subtractions.      I  ALGORITHM 
Since  the  numbers  are  binary,  the  only  question  is  whether  the  bit  ' 
in  the  quotient  is  0  or  1 ,  i.e..  whether  or  not  the  divisor  can  be  subtracted  from  what  is 
left  of  the  dividend.  Each  step  in  a  binary  division  can  be  reduced  to  the  following 
operation; 

If  the  divisor  can  be  subtracted  from  the  eight 
most  significant  bits  of  the  dividend  without 
a  borrow,  the  corresponding  bit  in  the  quo- 
tient IS  1 :  otherwise  it  is  0. 

The  only  remaining  problem  is  to  line  up  the  dividend  and  quotient  properly.  You  can 
do  this  by  shifting  the  dividend  and  quotient  logically  left  one  bit  before  each  tnal 
subtraction.  The  dividend  and  quotient  can  share  a  16-bit  register,  since  the  procedure 
clears  one  bit  of  the  dividend  at  the  same  time  as  it  determines  one  bit  of  the  quotient. 
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The  complete  process  for  binary  division  is: 

Step  1  -  Initialization: 
Quotient  =  0 
Counter  =  8 

Step  2  -  Shift  Dividend  and  Quotient  so  as  to  line  up  properly: 
Dividend  =  2  x  Quotient 
Quotient  =  2  x  Quotient 

Step  3  -  Perform  trial  Subtraction.  If  no  Borrow  add  1  to  Quotient: 
If  8  MSBs  of  Dividend  >  Divisor  then 
MSBs  of  Dividend  =  MSBs  of  Dividend  -  Divisor 
Quotient  =  Quotient  +  1 

Step  4  -  Decrement  counter  and  check  for  zero: 
Counter  =  Counter  -  1 
if  Counter  5^0,  go  to  Step  2 
Remainder  =  8  MSBs  of  Dividend 

In  the  case  of  sample  problem  b,  w/here  the  dividend  is  326D  Ihex)  and  the  divisor  is  47 
(hex),  the  process  works  as  follows: 

Initialization: 

Dividend 
Divisor 
Quotient 
Counter 

After  first  iteration  of  Steps  2  -  4: 

(Note  that  the  dividend  is  shifted  prior  to  the  trial  subtraction) 
Dividend  1DDA 
Divisor  47 
Quotient  01 
Counter  07 

After  second  iteration  of  Steps  2  -  4: 

Dividend  3BB4 
Divisor  47 
Quotient  02 
Counter  06 

Dividend  3068 

Divisor  47 

Quotient  05 

Counter  05 

Dividend  19D0 

Divisor  47 

Quotient  OB 

Counter  04 

Dividend  33A0 

Divisor  47 

Quotient  16 

Counter  03 


326D 
47 
00 
00 


After  third  iteration: 


After  fourth  iteration: 


After  fifth  iteration: 
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After  sixth  iteration: 

Dividend  2040 

Divisor  47 

Quotient  2D 

Counter  02 

After  seventh  iteration: 

Dividend  4080 

Divisor  47 

Quotient  5A 

Counter  01 

After  eighth  iteration; 

Dividend  3A00 

Divisor  47 

Quotient  B5 

Counter  00 

So  the  quotient  is  B5  and  the  remainder  is  3A. 

The  MSBs  of  dividend  and  divisor  are  assumed  to  be  zero  so  as  to  simplify  calculations 
(the  shift  prior  to  the  trial  subtraction  w/ould  otherwise  place  the  MSB  of  the  dividend  in 
the  Carry)-  Problems  that  are  not  m  this  form  must  be  simplified  by  removing  parts  of 
the  quotient  that  would  overflow  an  8-bit  word.  For  example: 

1024     400  (Hex)  _  . 100  (Hex) 
3  3  3 

The  last  problem  is  now  m  the  proper  form.  An  extra  division  may  be  necessary. 
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Flowchart: 


Source  Program: 

LD 
LD 
LD 
LD 

DIV:  ADD 
LD 
SUB 
JR 
LD 
INC 

CNT.  DJNZ 
LD 

HALT 


Q  Start  ^ 


Dividend 

(40  and  41) 

Divisor 

=  (42) 

Count 

=  8 

Quotient 

=  0 

Dividend  = 

Ix.  Dividend 
Quotient  '  = 

2  X  Quotient 
(Shift  both  left  1  fait) 


8  MSBs  of 
Dividend  =  8  MSBs 
of  Dividend  -  Divrsor 
Quotient  =Quot!ent-s- 1 


Count  =  Count  - 


HL,(40H)  ;GET  DIVIDEND 

A,  (42H)  ;GET  DIVISOR 
C,A 

B,  8  :COUNT  =  NUMBER  OF  BITS  IN  DIVISOR 
HLHL  ;SHIFT  DIVIDEND,  QUOTIENT  LEFT  1  BIT 
A,H  ;CAN  DIVISOR  BE  SUBTRACTED? 

C 

C,  CNT  ;N0,  GO  TO  NEXT  STEP 

H.A  ;YES.  SUBTRACT  DIVISOR  FROM  DIVIDEND 

L  ;ADD  1  TO  QUOTIENT 

DIV 

!43H),HL  :SAVE  QUOTIENT.  REMAINDER  IN  MEMORY 
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Object  Program: 


Memorv  Address 
(Hex) 

Memorv  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

2A 

LD 

HL.(40H) 

0001 

40 

0002 

00 

0003 

3A 

LD 

A,(42H) 

0004 

42 

0005 

00 

0006 

4F 

LD 

C,A 

0007 

06 

LD 

B.8 

0008 

08 

0009 

29 

DIV; 

ADD 

HL.HL 

OOOA 

7C 

LD 

A,H 

OOOB 

91 

SUB 

C 

OOOC 

38 

JR 

CCNT 

OOOD 

02 

OOOE 

67 

LD 

H.A 

OOOF 

2C 

INC 

L 

0010 

10 

CNT; 

DJNZ 

DIV 

0011 

F7 

0012 

22 

LD 

(43H),HL 

0013 

43 

0014 

00 

0015 

76 

HALT 

Register  Pair  HL  holds  both  the  dividend  and  the  quotient.  The  quotient  simpiv  replaces 
the  dividend  in  Register  L  as  the  dividend  is  shifted  left  logicallv- 

For  longer  division  problems,  vou  could  use  the  instruction  SBC  HL,  which  subtracts  the 
contents  of  a  register  pair  and  the  contents  of  the  Carrv  from  the  contents  of  Register 
Pair  HL. 

The  instruction  INC  L  sets  the  least  significant  bit  of  the  quotient  to  1 .  since  ADD  HLHL 
has  previously  cleared  that  bit. 

Division  is  necessarv  in  calculators,  terminals,  communications  error  checking,  control 
algorithms,  and  manv  other  applications. 

This  algorithm  takes  between  400  and  430  clock  cycles  to  divide  on  a  ZSO 
microprocessor.  The  precise  time  depends  on  the  number  of  one  bits  in  the  quotient. 
Other  algorithms  may  reduce  the  average  execution  time  somewhat,  but  400  clock  cy- 
cles will  still  be  typical  for  a  software  division.  Some  of  the  references  listed  at  the  end 
of  this  chapter  discuss  faster  methods  for  implementing  division. 
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Self-Checking  Numbers 
Double  Add  Double  Mod  10 

Purpose:  Calculate  a  checksum  digit  from  a  string  of  BCD  digits.  The  length  of  the 
string  of  digits  (number  of  words)  is  in  memory  location  0041 ;  the  string  of 
digits  (2  BCD  digits  to  a  word)  starts  in  memory  location  0042.  Calculate  the 
checksum  digit  by  the  Double  Add  Double  Mod  1 0  technique^  and  store  it  in 
memory  location  0040. 


SELF-CHECKING 
NUMBERS 


iCKING  I 


The  Double  Add  Double  Mod  10  technique  works  as  follows: 

1)  Clear  the  checksum  to  start. 

2)  Multiply  the  leading  digit  by  two  and  add  the  result  to  the 
checksum. 

3)  Add  the  next  digit  to  the  checksum. 

4)  Continue  the  alternating  process  until  you  have  used  all  the  digits. 

5)  The  least  significant  digit  of  the  checksum  is  the  self-checking  digit. 

Self-checking  digits  are  commonly  added  to  identification  numbers  on  credit  cards,  in- 
ventory tags,  luggage,  parcels,  etc..  when  they  are  handled  by  computenzed  systems. 
They  may  also  be  used  in  routing  messages,  identifying  files,  and  other  applications. 
The  purpose  of  the  digits  is  to  minimize  entry  errors  such  as  transposing  digits  (69  in- 
stead of  96),  shifting  digits  (7260  instead  of  3726),  missing  digits  by  one  (65  instead  of 
64),  etc.  You  can  check  the  self-checking  number  automatically  for  correctness  upon 
entry  and  can  eliminate  many  errors  immediately. 

The  analysis  of  self-checking  methods  is  quite  complex.  For  example,  a  plain  checksum 
will  not  find  transposition  errors  (4  +  9=9-1-4).  The  Double  Add  Double  algorithm  will 
find  simple  transposition  errors  (2  x  4  -I-  9  =  17  2  x  9  4):  but  will  miss  some  errors, 
such  as  transpositions  across  even  numbers  of  digits  (367  instead  of  763).  However, 
this  method  will  find  many  common  errorsi  The  value  of  a  method  depends  on  what  er- 
rors it  will  detect  and  on  the  probability  of  particular  errors  in  an  application. 

For  example,  if  the  string  of  digits  is 

549321 

the  result  will  be: 

Checksum  =  5x2-1-4-1-9x2-1-3  +  2x2-1-1  =40 


Self-checking  digit  =  0  (least  significant  digit  of  a  checksu 


[ml 


Note  that  an  erroneous  entry  like  543921  would  produce  a  different  self-checking  digit 
(4),  but  erroneous  entries  like  049321  or  945321  would  not  be  detected. 

Sample  Problems: 

a.  (0041)   =  03 

(0042)  =  36 

(0043)  =  68 
10044)   =  51 

Result:  Checksum  =  3x2  +  6  +  6x2  +  8  +  5x2+1  =43 
(0040)   =  03 

b.  (0041)   =  04 

(0042)  =  50 

(0043)  =  29 

(0044)  =  16 

(0045)  =  83 

Result:  Checksum  =  5x2  +  0  +  2x2  +  9+1x2  +  6  +  8x2  +  3=  50 
(0040)   =  00 
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Flowchart: 


f  " 

Checksum  =  0  i 

Count  =  (41)1 

Pointer  =  42  1 


MSD  =(Pointerl/16 
LSD  =  Pointer  AND 
00001111B 
Checksum  ^Checksum 
+  2xMSD  =LSD 
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Source  Program: 


LD 

A.!41H) 

COUNT  =  LENGTH  OF  STRING  IN  BYTES 

LD 

B,A 

LD 

CO  :CHECKSUM=0 

LD 

HL,42H 

POINT  TO  START  OF  STRING  OF  DIGITS 

CHDIG:  LD 

A,(HL) 

GET  TWO  BCD  DIGITS  FROM  STRING 

LD 

D.A             :SAVE  COPY 

RRA 

;GET  MSD  BY  SHIFTING  AND  MASKING 

RRA 

RRA 

RRA 

AND 

00001 n IB 

ADD 

A. A 

DOUBLE  M'iD 

DAA 

MAKE  DOUBLED  MSD  DECIMAL 

ADD 

A.C 

ADD  DOUBLED  MSD  TO  CHECKSUM 

DAA 

KEEP  CHECKSUM  DECIMAL 

LD 

C.A 

LD 

A,D 

GET  LEAST  SIGNIFICANT  DIGIT 

AND 

00001 11  IB 

(MASK  OUT  MSD) 

ADD 

A.C 

ADD  LSD  TO  CHECKSUM 

DAA 

KEEP  CHECKSUM  DECIMAL 

LD 

C.A 

INC 

HL 

DJNZ 

CHDIG 

AND 

00001 11  IB 

MASK  OFF  SELF-CHECKING  DIGIT 

LD 

{40H).A 

SAVE  SELF-CHECKING  DIGIT 

HALT 
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Object  Program: 

Memory  Address 

Memory  Contents 

Instruction 

1  (Hex) 

(Hex) 

iMnemonic) 

OM 

LD 

A,(41H) 

uuu  t 

uuuz 

UU 

UUUo 

HI 

LD 

B.A 

AnriA 

UUUh 

Utl 

LD 

CO 

nnnp; 

UU 

UUUD 

01 

LD 

HL,42H 

uuu/ 

nnnn 

1  UUUO 

nn 

UU 

1  nnnQ 

1  uuuy 

CHDIG:  LD 

A,(HL) 

1  UUUM 

R7 

LD 

D.A 

UUUD 

1  r 

RRA 

nnnr* 

UUUu 

!  r 

RRA 

nnnn 
uuuu 

!  r 

RRA 

nnnp 
uuut 

i  r 

RRA 

nnnp 

UUUr 

PR 

AND 

00001 11  IB 

nni  n 

UU  !  u 

np 
ur 

nni  1 

UU  1  1 

P7 

o/ 

ADD 

A.A 

nni  9 

UU  I  £. 

LI 

DAA 

nni  "5 

UU  1  o 

O  1 

ADD 

A.C 

0014 

27 

DAA 

0015 

4F 

LD 

C,A 

UU  1  u 

7A 

LD 

A.D 

nni  7 

UU  i  / 

PR 
CD 

AND 

000011118 

nni  fl 

UU  1  o 

np 

ur 

nni  Q 

UU  1  3 

81 

ADD 

A.C 

UU  i  M 

07 

DAA 

nni  ta 
UU  1  b 

LD 

C,A 

UU  1 L. 

INC 

HL 

001  D 

10 

DJNZ 

CHDIG 

001 E 

EA 

001 F 

E6 

AND 

00001 11  IB 

0020 

OF 

0021 

32 

LD 

(40H),A 

0022 

40 

0023 

00 

0024 

76 

HALT 

The  digits  are  removed  by  shifting  and  masking.  Four  right  shifts  are  needed  to  separate 
out  the  most  significant  digit. 

A  decimal  adjust  (DAA)  must  follow  each  addition  to  produce  the  proper  decimal  result. 
A  single  DAA  after  a  series  of  additions  will  not  work  (try  iti).  Remember  that  DAA 
works  only  on  the  Accumulator. 

There  is  no  problem  with  carries  from  the  decimal  sum.  since  the  procedure  uses  only 
the  least  significant  digit  of  the  checksum  anyway. 
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An  alternative  (and  superior)  approach  is  to  use  the  Z80 
decimal  shift  instruction  RLD.  This  Instruction  is  a  4-blt 


DECIMAL  SHIFT 
INSTRUCTIONS 


shift  that  moves  the  contents  of  the  four  least  significant  i— — ^— — — i 
bits  of  the  memory  location  addressed  by  HL  Into  the  four  most  significant  bits  of  that 
location,  the  previous  contents  of  the  four  most  significant  bits  of  that  location  into  the 
four  least  significant  bits  of  the  Accumulator,  and  the  previous  contents  of  the  four 
least  significant  bits  of  the  Accumulator  into  the  four  least  significant  bits  of  the  memo- 
ry location.  Thus,  RLD  not  only  moves  a  single  digit  to  the  Accumulator,  but  it  also 
shifts  the  next  digit  so  that  it  can  be  moved  to  the  Accumulator  with  the  next  RLD. 
Figure  8-1  shows  an  example  of  how  RLD  works:  RRD  Is  the  same  Instruction  except 
that  the  shift  Is  right  Instead  of  left. 

The  Double  Add  Double  Mod  10  algorithm  can  be  implemented  as  follows  using  RLD; 
Source  Program: 


LD 
LD 
LD 
LD 


A,(41H) 


:COUNT  =LENGTH  OF  STRINGS  (IN  BYTES) 


B,A 
CO 


CHECKSUM  =0 

POINT  TO  START  OF  STRING  OF  DIGITS 

.CLEAR  MSD 

:GET  MSD  FROM  STRING 

:DOUBLE  MSD 

;MAKE  DOUBLED  MSD  DECIMAL 
;ADD  DOUBLED  MSD  TO  CHECKSUM 
:KEEP  CHECKSUM  DECIMAL 


CHDIG.  SUB 


HL.42H 
A 


RLD 

ADD 

DAA 

ADD 

DAA 

LD 

SUB 

RLD 

ADD 

DAA 

LD 

INC 

DJNZ 

AND 

LD 

HALT 


A.A 


C,A 
A 


A,C 


A.C 


C,A 

HL 

CHDIG 

00001 11  IB  ;MASK  OFF  SELF-CHECKING  DIGIT 
(40H),A        ;SAVE  SELF-CHECKING  DIGIT 


■.CLEAR  MSD 
;GET  LSD  FROM  STRING 
:ADD  LSD  TO  CHECKSUM 
■.KEEP  CHECKSUM  DECIMAL 
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Object  Program: 


Memorv  Address 
(Hex) 

Memorv  Contents 
(Hex! 

Instruction 
(Mnemonic) 

Annn 
UUUU 

LD 

A,(41H) 

UUU 1 

A  1 

UUUz 

AA 

uU 

AAAQ 

UUUo 

A~I 

LD 

B,A 

AAA/l 
UUU4 

ACT 

ut 

LD 

CO 

AAAC 

uuub 

AA 
UU 

UUUD 

Z  i 

LD 

HL,42H 

UUU/ 

AO 
4Z 

0008 

00 

Q7 

CHDIG;  SUB 

A 

UUUM 

pn 

RLD 

UUUD, 

ur 

nnnr 

O  / 

ADD 

A.A 

nnnn 

UUUU 

97 
z  / 

DAA 

uuuc 

O  ' 

ADD 

A,C 

nnnp 

UUUr 

97 
z  / 

DAA 

UU  1  U 

4r 

LD 

C,A 

AA1  1 
UU  1  1 

Q7 

SUB 

A 

AA1  O 
UU  !  Z 

ED 

RLD 

UU  1  O 

Or 

AAI  A 
Uu  i  4 

O  1 

ADD 

A.C 

AAI  K 
UU  1  D 

z/ 

DAA 

0016 

4F 

LD 

C,A 

0017 

23 

INC 

HL 

0018 

10 

DJNZ 

CHDIG 

0019 

EF 

001 A 

E6 

AND 

00001 11  IB 

001 B 

OF 

001 C 

32 

LD 

(40H),A 

001 D 

40 

001 E 

00 

001 F 

76 

HALT 

We  could  improve  this  program  even  further  (it  is  already  shorter  than  the  previous  ver- 
sion). Since  we  are  dropping  the  most  significant  digit  at  the  end  anyway,  there  is  no 
reason  to  clear  it  out  each  time  with  the  SUB  A  instruction. 
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Initial  Conditions 

(HU=4000 
(A)  =  7F 
(40OO)  »  12 

After  RLD 
(A)  =  71 
(4000)  =  2F 

Before 

Accumulator 


High-order  bit  =0.  set  S  to  0  - 
4  ones,  set  P/0  to  1 


(A)  =  72 
(4000)  =  F 


Before 

Accumuiator 


Memory 


4  ones,  set  P/0  to  1 


Accumuiator 


"  Non-zero  result, 
set  2  to  0 


Accumutator 


1 

2 

7 

'  1 

Non-zero  result, 
set  Z  to  0 


Figure  8-1.  Examples  of  the  Z80  Digit  Shifts 

You  can  double  a  decimal  number  (in  the  Accumulator)  by 
adding  it  to  itself  and  then  performing  a  decimal  correction, 
I.e., 


ADD 
DAA 


:DOUBLE  NUMBER 

;AND  MAKE  RESULT  DECIMAL 


DOUBLING 
AND  HALVING 
BINARY 
NUMBERS 


Remember  that  the  Accumulator  can  hold  only  valid  decimal  digits  in  the  range  0-99. 

You  cannot  use  SLA  A  (Shift  Left  Arithmetic  A)  because  that  instruction  always  clears 
the  Half-Carry  (only  Add  and  Subtract  instructions  set  H  properly). 

You  can  divide  a  decimal  number  by  two  simply  by  shifting  it  right  logically  and  then 
subtracting  three  from  any  digit  that  is  eight  or  larger  (since  10  BCD  is  16  binary).  The 
following  program  divides  a  decimal  number  in  memory  location  0040  by  two  and 
places  the  result  into  memory  location  0041. 
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LD 

A,(40H) 

;GET  DECIMAL  NUMBER 

SRL 

A 

.DIVIDE  BY  2  IN  BINARY 

BIT 

3,A 

;IS  LEAST  SIGNIFICANT  DIGIT  8  OR  MORE? 

JR 

Z.DONE 

SUB 

3 

:YES,  SUBTRACT  3  FOR  DECIMAL  CORRECTION 

LD 

(41H),A 

;STORE  NUMBER  DIVIDED  BY  2 

HALT 

DONE: 


Trv  this  program  and  the  method  on  the  decimal  numbers  28,  30.  and  37  Do  you  un- 
derstand why  It  works? 


Rounding  is  simple  whether  the  numbers  are  binary  or  decimal.  A  BINARY 
binary  number  can  be  rounded  as  follows:  ROUNDING 

If  the  most  significant  bit  to  be  dropped  is  1. 
add  1  to  the  remaining  bits.  Otherwise,  leave 
the  remaining  bits  alone. 

This  rule  works  because  1  is  halfway  between  0  and  10  in  binary,  much  as  5  is  halfway 
in  decimal  (note  that  0.5  decimal  =  0.1  binary). 

So,  the  following  program  will  round  a  16-bit  number  in  memory  locations  0040  and 
0041  (MSBs  in  0041)  to  an  8-bit  number  in  memory  location  0041. 


DONE; 


LD 

BIT 

JR 

INC 

INC 

HALT 


HL,40H 

7,(HU 

Z,DONE 

HL 

(HL) 


;IS  MSB  OF  EXTRA  BYTE  1  ? 
:N0,  ROUND  UP 


DECIMAL 
ROUNDING 


If  the  number  is  longer  than  16  bits,  the  rounding  must  ripple  through  the  other  bytes 
as  needed. 

Decimal  rounding  is  a  bit  more  difficult  because  the  crossover 
point  IS  now  BCD  50  and  the  rounding  must  produce  a  decimal 
result.  The  rule  is: 

If  the  most  significant  digit  is  to  be  dropped 
IS  5  or  more,  add  1  to  the  remaining  digits. 

The  following  program  will  round  a  4-digit  BCD  number  in  memory  locations  0040  and 
0041  (MSBs  in  0041)  to  a  2-digit  BCD  number  in  memory  location  0041. 


:IS  BYTE  TO  BE  DROPPED  50  OR  MORE? 


LD 

HL,40H 

LD 

A,(HL) 

CP 

50H 

JR 

CDONE 

INC 

HL 

LD 

A,(HL) 

ADD 

A.1 

DAA 

LD 

(HU.A 

HALT 

:YES,  ROUND  MSB'S  UP 


:KEEP  DIGITS  DECIMAL 


DONE; 

Remember  that  the  DAA  instruction  works  only  on  numbers  in  the  -Accumulator,  in  this 
case,  we  could  round  with  the  instruction  INC  A.  since  we  know  that  the  Carry  is  zero 
(why' — remember  the  JR  instruction).  Normally,  we  need  the  sequence  ADD  A,l 
followed  by  DAA,  since  INC  A  does  not  affect  the  Carry. 
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SIGN 

PROPAGATION 


Very  often  when  performing  multibyte  twos  complement 
signed  arithmetic,  it  is  necessary  to  propagate  the  sign  bit 
through  the  high-order  bytes.  This  operation  can  be  performed 
in  a  straightforward  manner  if,  as  is  usually  the  case,  the  sign  is  in  the  Carry.  The  SBC 
A, A  instruction  has  the  effect  of  propagating  the  state  of  the  Carry  throughout  a  word. 
Since  A-.A  always  equals  0,  SBC  A,A  is  equivalent  to  subtracting  the  Carry  from  0  and 
can  yield  only  the  values  0  and  FFH. 

PROBLEMS 

1)    Multiple-Precision  Subtraction 

Purpose:  Subtract  one  multiple-word  number  from  another.  The  length  of  the  num- 
bers IS  in  memory  location  0040,  the  numbers  themselves  start  (least  signifi- 
cant bits  first)  in  memory  locations  0041  and  0051,  respectively,  and  the 
difference  replaces  the  number  starting  in  memory  location  0041.  Subtract 
the  number  starting  in  0051  from  the  one  starting  in  0041. 

Sample  Problem: 


Result: 


that  IS, 


(0040) 

04 

(0041) 

C3 

(0042) 

A7 

(0043) 

5B 

(0044) 

2F 

(0051) 

B8 

(0052) 

35 

(0053) 

DF 

(0054) 

14 

(0041) 

08 

(0042) 

72 

(0043) 

7C 

(0044) 

1A 

2F5BA7C3 

14DF35B8 

1A7C720B 

2)    Decimal  Subtraction 

Purpose:  Subtract  one  multiple-word  decimal  (BCD)  number  from  another.  The  length 
of  the  numbers  is  in  memory  location  0040,  the  numbers  themselves  start 
(least  significant  bits  first)  in  memory  locations  0041  and  0051.  respectively, 
and  the  difference  replaces  the  number  starting  in  memory  location  0041. 
Subtract  the  number  starting  in  0051  from  the  one  starting  in  0041. 

Sample  Problem: 


(0040) 

=  04 

(0041) 

=  85 

(0042) 

=  19 

(0043) 

=  70 

(0044) 

=  36 

(0051) 

=  59 

(0052) 

=  34 

(0053) 

=  66 

(0054) 

=  12 
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Result;   (0041)  =  26 

(0042)  =  85 

(0043)  =  03 

(0044)  =  24 

that  IS.  36701985 
1 2663459 


24038526 

3)  8-Bit  by  16-Bit  Binary  Multiplication 

Purpose:  Multiply  the  16-bit  unsigned  number  in  memorv  locations  0040  and  0041 
(nnost  significant  bits  in  0041)  by  the  8-bit  unsigned  nunnber  in  memory  loca- 
tion 0042.  Store  the  result  in  memory  locations  0043  through  0045.  with  the 
most  significant  bits  in  memory  location  0045. 

Sample  Problems: 

a.  (0040)    =  03 

(0041)  =  00 

(0042)  =  05 

Result:    (0043)    =  OF 

(0044)  =  00 

(0045)  =  00 

that  IS,  3x5  =  15 

b.  (0040)    =  6F 

(0041)  =  72  (29,295  decimal) 

(0042)  =  61  (97  decimal) 

Result;   (0043)   =  OF 

(0044)  =  5C 

(0045)  =  2B 

that  IS,  29,295x97  =2,841.615 

4)  Signed  Binary  Division 

Purpose:  Divide  the  16-bit  signed  number  in  memory  locations  0040  and  0041  (most 
significant  bits  in  0041  by  the  8-bit  signed  number  in  memory  location  0042. 
The  numbers  are  normalized  so  that  the  magnitude  of  memory  location  0042 
IS  greater  than  the  magnitude  of  memory  location  0041.  Store  the  quotient 
(signed)  in  memory  location  0043  and  the  remainder  (always  positive)  in 
memory  location  0044, 

Sample  Problems: 

a. 


Result: 


(0040) 

=  CO 

(0041) 

=  FF  (-64) 

(0042) 

=  08 

(0043) 

=  F8  (-8)  quotient 

(0044) 

=  00  (0)  remainder 

(0040) 

=  93 

(0041) 

=  ED  (-4717) 

(0042) 

=  47  (71  decimal) 

(0043) 

=  BD  (-67  decimal) 

(0044) 

=  28  (-t-40  decimal) 

Result; 


Hint:  Determine  the  sign  of  the  result,  perform  an  unsigned  division,  and  ad- 
|ust  the  quotient  and  remainder  properly. 
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5)    Self -Checking  Numbers  Aligned  1,  3,  7  Mod  10 

Purpose:  Calculate  a  checksum  digit  from  a  strmg  of  BCD  digits.  The  length  of  the 
string  of  digits  (number  of  words)  is  in  memory  location  0041 .  the  string  of 
digits  (2  BCD  digits  to  a  word)  starts  in  memory  location  0042.  Calculate  the 
checksum  digit  by  the  Aligned  1 .  3,  7  Mod  1 0  method  and  store  it  in  memory 
location  0040. 

The  Aligned  1 ,  3,  7  Mod  10  technique  works  as  follows: 

1)  Clear  the  checksum  to  start. 

2)  Add  the  leading  digit  to  the  checksum. 

3)  Multiply  the  next  digit  by  3  and  add  the  result  to  the  checksum. 

4)  Multiply  the  next  digit  by  7  and  add  the  result  to  the  checksum. 

5)  Continue  the  process  (Steps  2-4)  until  you  have  used  all  the  digits. 

6)  The  self-checking  digit  is  the  least  significant  digit  of  the  checksum. 
For  example,  if  the  string  of  digits  is: 

549321 

the  result  will  be: 

Checksum   =  5  +  3x4-(-7x9-(-3  +  3x2-l-7x1=96 
Self-checking  digit  =  6 
Sample  Problems: 

a.  (0041)   =  03 

(0042)  =  36 

(0043)  =  68 

(0044)  =  51 

Result:  Checksum  =  3-l-3x6-i-7x6-(-8-l-3x5-t-7x1  =93 
(0040)   =  03 

b.  (0041)  =  04 

(0042)  =  50 

(0043)  =  29 

(0044)  =  16 

(0045)  =  83 

Result:  Checksum  =  5  +  3x0-f7x2  +  9-l-3x1-t-7x6  +  8 
+  3  X  3  =  90 
(0040)   =  00 

Hint:  Note  that  7=2x34-1  and  3  =  2x1-1-1.  so  the  formula 
Mj  =  2  X  Mj_i  +  1  can  be  used  to  calculate  the  next  multiplying  factor. 
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Chapter  9 
TABLES  AND  LISTS 


Tables  and  lists  are  two  of  the  basic  data  structures  used  with  all  computers.  We  have 
already  seen  tables  used  to  perform  code  conversions  and  arithmetic.  Tables  may  also 
be  used  to  identify  or  respond  to  commands  and  instructions,  linearize  data,  provide  ac- 
cess to  files  or  records,  define  the  meaning  of  keys  or  switches,  and  choose  among 
alternate  programs.  Lists  are  usually  less  structured  than  tables.  Lists  may  record  tasks 
that  the  processor  must  perform,  messages  or  data  that  the  processor  must  record,  or 
conditions  that  have  changed  or  should  be  monitored.  Tables  are  a  simple  way  of  mak- 
ing decisions  or  solving  problems,  since  no  computations  or  logical  functions  are 
necessary.  The  task,  then,  reduces  to  organizing  the  table  so  that  the  proper  entry  is 
easy  to  find.  Lists  allow  the  execution  of  sequences  of  tasks,  the  preparation  of  sets  of 
results,  and  the  construction  of  interrelated  data  files  (or  data  bases).  Problems  include 
how  to  add  elements  to  a  list  and  remove  elements  from  it 

EXAMPLES 

Add  Entry  to  List 

Purpose:  .Add  the  contents  of  memory  location  0040  to  a  list  if  it  is  not  already  pre- 
sent in  the  list.  The  length  of  the  list  is  in  memory  location  0041  and  the  list 
Itself  begins  in  memory  location  0042. 

Sample  Problems: 

a.  (0040)   =  6B 

(0041)  =  04 

(0042)  =  37 

(0043)  =  61 
(00441  =  38 

(0045)  =  ID 

Result:   (00411   =  05 

(0046)  =  6B 

The  entry  is  added  to  the  list,  since  it  is  not  already  present.  The  length  of  the  list  is  in- 
creased by  1. 

b.  (0040)   =  6B 

(0041)  =  04 

(0042)  =  37 

(0043)  =  68 

(0044)  =  38 

(0045)  =  ID 

Result:  No  change,  since  the  entry  is  already  in  the  list. 
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Flowchart: 


(Pointer)  = 

Entry 

(41)  = 

(41)  +  1 

c 


Source  Program: 


SRLST 


DONE: 


LD 

HL,40H 

POINT  TO  ENTRY 

LD 

A.iHL) 

GET  ENTRY 

INC 

HL 

POINT  TO  COUNT 

LD 

B,!HU 

COUNT  =  LENGTH  OF  LIST 

INC 

HL 

POINT  TO  START  OF  LIST 

CP 

(HL) 

IS  ENTRY  =  ELEMENT  IN  LIST? 

JR 

Z.DONE 

YES,  THROUGH 

INC 

HL 

NO,  GO  ON  TO  NEXT  ELEMENT 

DJNZ 

SRLST 

LD 

(HL),A 

ADD  ENTRY  TO  LIST 

LD 

HL,41H 

ADD  1  TO  LIST  LENGTH 

INC 

(HL) 

HALT 
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Object  Program: 


Memory  Address 
(Hex) 

Memorv  Contents 
(Hex) 

Instruction 
(Mnemonic) 

nnnn 

91 

LD 

HL,40H 

nnm 

KJUU  1 

AA 

anno 

AA 
UU 

UUUO 

/ 1: 

LD 

A.(HL) 

uuu^ 

Zo 

INC 

HL 

AnnR 
uuuo 

'tO 

LD 

B.IHLl 

UUUO 

INC 

HL 

uuu/ 

DC 

CDI  CT 
OrlLo  ! 

CP 

(HL) 

UUUC3 

JR 

Z.DONE 

AAAQ 

uuuy 

AJ3 

AAA  A 
UUUA 

INC 

HL 

AAAR 
UUUD 

1  A 
1  U 

DJNZ 

SRLST 

oooc 

FA 

GOOD 

77 

ADELM: 

LD 

(HL),A 

OOOE 

21 

LD 

HL,41H 

OOOF 

41 

0010 

00 

0011 

34 

INC 

(HL) 

0012 

76 

DONE. 

HALT 

We  could  also  use  the  block  search  instruction  CPIR  in  our  example,  as  follows: 
Source  Program: 


DONE: 


LD 

HL,40H 

;POINT  TO  ENTRY 

LD 

A,(HU 

;GET  ENTRY 

INC 

HL 

:POINT  TO  COUNT 

LD 

B,0 

:  COUNT  =  LENGTH  OF  LIST  (16  BITS) 

LD 

C,(HL) 

INC 

HL 

;POINT  TO  START  OF  LIST 

CPIR 

:LOOK  FOR  ENTRY  IN  LIST 

JR 

Z.DONE 

;DONE  IF  ENTRY  FOUND 

LD 

(HU.A 

:OTHERWISE.  ADD  ENTRY  TO  LIST 

LD 

HL.41H 

;ADD  1  TO  LIST  LENGTH 

HALT 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

7E 

LD 

A,(HL) 

0004 

23 

INC 

HL 

0005 

06 

LD 

B.O 

0006 

00 

0007 

4E 

LD 

C,(HL) 

0008 

23 

INC 

HL 

0009 

ED 

CPIR 

OOOA 

B1 

OOOB 

28 

JR 

Z.DONE 

OOOC 

05 

OOOD 

77 

LD 

(HL),A 

OOOE 

21 

LD 

HL,41H 

OOOF 

41 

0010 

00 

0011 

34 

INC 

(HL) 

0012 

76 

DONE:  HALT 

Remember  that  CPIR  automatically  repeats  the  basic  Search  instruction  until  either  BC 
is  decremented  to  zero  or  a  true  comparison  occurs  (i.e.,  A  =  (HL)). 

Be  careful  of  the  following  slight  differences  from  the  previous  version: 

1)  BC  is  a  16-bit  counter.  Thus,  CPIR  can  handle  strings  longer  than  256  bytes. 

2)  The  Parity/Overflow  bit  (P/0)  is  cleared  if  BC  is  decremented  to  zero,  and  set  other- 
wise.   

Clearly,  this  method  of  adding  elements  is  very  inefficient  if  the  list  [  HASHING  ) 
is  long.  We  could  improve  the  procedure  by  limiting  the  search  to 
part  of  the  list  or  by  ordering  the  list.  We  could  limit  the  search  by  using  the  entry  to  get 
a  starting  point  in  the  list.  This  method  is  called  "hashing",  and  is  much  like  selecting  a 
starting  page  in  a  dictionary  or  directory  on  the  basis  of  the  first  letter  in  an  entry.  We 
could  order  the  list  by  numerical  value.  The  search  could  then  end  when  the  list  values 
went  beyond  the  entry  (larger  or  smaller,  depending  on  the  ordering  technique  used).  A 
new  entry  would  have  to  be  inserted  properly,  and  all  the  other  entries  would  have  to  be 
moved  down  in  the  list. 

The  program  could  be  restructured  to  use  two  tables.  One  table  could  provide  a  starting 
point  in  the  other  table;  for  example,  the  search  point  could  be  based  on  the  most  or 
least  significant  4-bit  digit  in  the  entry. 
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The  program  does  not  work  if  the  length  of  the  list  could  be  zero  (what  happens?).  We 
could  avoid  this  problem  bv  checking  the  length  initially.  The  initialization  procedure 
for  the  first  program  would  then  be: 


LD 

HL.40H 

POINT  TO  ENTRY 

LD 

A,(HL) 

GET  ENTRY 

INC 

HL 

POINT  TO  LENGTH 

LD 

B,(HL) 

COUNT  =  LENGTH  OF  LIST 

INC 

HL 

POINT  TO  START  OF  LIST 

INC 

B 

IS  COUNT  ZERO' 

DEC 

B 

JR 

Z.ADELM 

YES.  GO  ADD  ENTRY  TO  LIST 

ADELM:    LD  (HL),A  ;ADD  ENTRY  TO  LIST 

Note  that  the  sequence  INC,  DEC  is  an  easy  way  to  check  for  a  zero  value  in  a  register 
without  using  the  Accumulator  or  changing  the  value  in  the  register. 

The  procedure: 

LD  HLADDR 
INC  !HL) 

is  a  quick  way  to  add  1  to  a  counter  in  memory  location  ADDR  without  using  the  Ac- 
cumulator. You  can  use  DEC  (HL)  in  a  similar  manner  to  subtract  1  from  the  counter.  LD 
(HL), CONST  can  place  a  starting  value  (such  as  zero)  In  the  counter.  Memory  locations 
should,  of  course,  be  used  for  counters  only  when  no  readily  accessible  registers  are 
available. 

If  each  entry  were  longer  than  one  word,  a  pattern-matching  program  would  be  necess- 
ap/.  The  program  would  have  to  proceed  to  the  next  entry  if  a  match  failed;  that  is,  skip 
over  the  last  part  of  the  current  entry  once  a  mis-match  was  found. 

Check  an  Ordered  List 

Purpose;    Check  the  contents  of  memory  location  004-1  to  see  if  it  is  in  an  ordered  list. 

The  length  of  the  list  is  in  memory  location  0042;  the  list  itself  begins  in 
memory  location  0043  and  consists  of  unsigned  binary  numbers  in  increas- 
ing order.  If  the  contents  of  location  0041  is  in  the  list,  clear  memory  loca- 
tion 0040;  otherwise,  set  memon/  location  0040  to  FF  (hex). 

Sample  Problems: 

a.  (0041)   =  6B 

(0042)  =  04 

(0043)  =  37 

(0044)  =  55 

(0045)  =  7D 

(0046)  =  A1 

Result:   (0040)   =  FF,  since  6B  is  not  in  the  list. 

b.  (0041)   =  6B 

(0042)  =  04 

(0043)  =  37 

(0044)  =  55 

(0045)  =  68 

(0046)  =  A1 

Result:   (0040)   =  00,  since  68  is  in  the  list. 
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Flowchart: 


The  searching  process  is  a  bit  different  here  since  the  elements  are  ordered.  Once  we 
find  an  element  larger  than  the  entry,  the  search  is  over,  since  subsequent  elements  will 
be  even  larger.  You  may  want  to  try  an  example  to  convince  yourself  that  the  procedure 
works. 

As  in  the  previous  problem,  a  table  or  other  method  that  could       j  SEARCHING 
choose  a  good  starting  point  would  speed  up  the  search.  One      [  METHODS 
method  would  be  to  start  in  the  middle  and  determine  which  half 
of  the  list  the  entry  was  in,  then  divide  the  half  into  halves,  etc.  This  method  is  called  a 
binary  search,  since  it  divides  the  remaining  part  of  the  list  in  half  each  time.^ 
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Source  Program: 


SRLST; 


NOTIN: 
DONE: 


1  n 

LU 

Ul    y1  1  U 

nL,'*- 1  n 

LU 

A  /Mi  \ 

IMP 

MI 
NL 

p  (mi  i 

i  n 

LU 

p  n 

IMP 

Ml 
nL 

CP 

(Ml  ) 

Jn 

C.,L/\Ji\C. 

JR 

C.NOTIN 

INC 

HL 

DJNZ 

SRLST 

LD 

C.OFFH 

LD 

A.C 

LD 

{40H),A 

HALT 

POINT  TO  ENTRY 

GET  ENTRY 

POINT  TO  LENGTH 

COUNT  =  LENGTH  OF  LIST 

MARK  =  ZERO  FOR  IN  LIST 

POINT  TO  START  OF  LIST 

IS  ENTRY  =  ELEMENT  IN  LIST' 

YES  SEARCH  COMPLETED 

ENTRY  NOT  IN  LIST  IF  LESS  THAN  ELEMENT 


:MARK  =  FF  FOR  NOT  IN  LIST 
;SAVE  MARK 


Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL,41H 

0001 

41 

0002 

00 

0003 

7E 

LD 

A.{HL) 

0004 

23 

INC 

HL 

0005 

46 

LD 

B,(HL) 

0006 

OE 

LD 

CO 

0007 

00 

0008 

23 

INC 

HL 

0009 

BE 

SRLST; 

CP 

(HU 

OOOA 

28 

JR 

Z.DONE 

OOOB 

07 

OOOC 

38 

JR 

CNOTIN 

GOOD 

03 

OOOE 

23 

INC 

HL 

OOOF 

10 

DJNZ 

SRLST 

0010 

F8 

0011 

OE 

NOTIN: 

LD 

C.OFFH 

0012 

FF 

0013 

79 

LD 

A.C 

0014 

32 

LD 

(40H),A 

0015 

40 

0016 

00 

0017 

76 

HALT 

The  Z80  block  search  instructions  are  not  as  useful  here  as  in  the  previous  example 
because  we  want  to  do  more  than  a  simple  search.  Now  we  also  want  to  check  to  see  if 
we  have  examined  the  relevant  part  of  the  list  (i.e.,  the  part  where  the  elements  are  less 
than  or  equal  to  the  entry).  Try  rewriting  the  program  to  use  CPI.  Remember  that  you 
must  use  the  Parity/Overflow  flag  to  determine  if  the  byte  counter  has  been  decre- 
mented to  zero. 
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Remove  Element  from  Queue 

Purpose:  Memory  locations  0042  and  0043  contain  the  address  of  the  head  of  the 
queue  (MSBs  m  0043).  Place  the  address  of  the  first  elennent  Ihead)  of  a 
queue  into  memop/  locations  0040  and  0041  (MSBs  In  0041)  and  update 
the  queue  to  remove  the  element.  Each  element  in  the  queue  is  two  bytes 
long  and  contains  the  address  of  the  next  two-byte  element  in  the  queue. 
The  last  element  in  the  queue  contains  zero  to  indicate  that  there  is  no  next 
element. 

Queues  are  used  to  store  data  in  the  order  in  which  it  will  be  used,  or  tasks  in  the  order 
in  which  they  will  be  executed.  The  queue  is  a  first-in,  first-out  data  structure;  i.e..  ele- 
ments are  removed  from  the  queue  in  the  same  order  in  which  they  were  entered. 
Operating  systems  place  tasks  in  queues  so  that  they  will  be  executed  in  the  proper 
order.  I/O  drivers  transfer  data  to  or  from  queues  so  that  it  will  be  transmitted  or 
handled  in  the  proper  order.  Buffers  may  be  queued  so  that  the  next  available  one  can 
easily  be  found  and  those  that  are  released  can  easily  be  added  to  the  available  storage. 
Queues  may  also  be  used  to  link  requests  for  storage,  timing,  or  I/O  so  that  they  can  be 
satisfied  in  the  correct  order 

In  real  applications  each  element  in  the  queue  will  typically  contain  a  large  amount  of 
information  or  storage  space  besides  the  address  required  to  link  the  element  to  the 
next  one. 

Sample  Problems: 


a. 


(0042)  =  46; 

(0043)  =  00 

(0046)  =  4D 

(0047)  =  00 
(004D)  =  00 
(0040  =  00 


address  of  first  element  in  queue 
address  of  second  element  in  queue 
end  of  queue 


Result:    (0040)    =  46 


address  of  element  removed  from  queue 
address  of  new  first  element  in  queue 

empty  queue 

no  element  available  from  queue 


(0041)  =  00' 

(0042)  =  4D 

(0043)  =  00 


b. 


(0042)  =  00 

(0043)  =  00 


Result:   (0040)   =  00 
(0041)   =  00 
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Flowchart: 


Source  Program: 


DONE; 


LD 

HL,i42H) 

:GET  ADDRESS  OF  HEAD  OF  QUEUE 

LD 

{40H!.HL 

:  REMOVE  HEAD  OF  QUEUE 

LD 

A,H 

:IS  QUEUE  EMPTY? 

OR 

L 

JR 

Z.DONE 

:YES,  DONE 

LD 

E,(HU 

:N0,  GET  ADDRESS  OF  NEXT  ELEMENT 

INC 

HL 

LD 

D,(HU 

LD 

!42H),DE 

:MOVE  NEXT  ELEMENT  TO  HEAD  OF  QUEUE 

HALT 

Object  Program: 


Memorv  Address 

Memorv  Contents 

Instruction 

(Hex) 

(Hex! 

(Mnemonic) 

0000 

2A 

LD 

HL,(42H) 

0001 

42 

0002 

00 

0003 

22 

LD 

(40H),HL 

0004 

40 

0005 

00 

0006 

7C 

LD 

A,H 

0007 

B5 

OR 

L 

0008 

28 

JR 

Z.DONE 

0009 

07 

OOOA 

5E 

LD 

E,(HL) 

OOOB 

23 

INC 

HL 

OOOC 

56 

LD 

D,(HU 

OOOD 

ED 

LD 

{42H),DE 

OOOE 

53 

OOOF 

42 

0010 

00 

0011 

76 

DONE;  HALT 
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Queuing  can  handle  lists  that  are  not  in  sequential  memory  locations.  Each  element 
must  contain  the  address  of  the  next  element.  Such  lists  allow  vou  to  handle  data  or 
tasks  in  the  proper  order,  change  variables,  or  fill  in  definitions  in  a  program.  Extra 
storage  is  required,  but  elements  can  easily  be  added  to  the  queue  or  deleted  from  it. 

Note  the  use  of  the  sequence: 

LD  A,H 
OR  L 

to  determine  if  the  contents  of  a  16-bit  register  pair  is  zero.  Remember  that  INC  and 
DEC  do  not  affect  any  flags  when  applied  to  a  register  pair.  Try  to  devise  some  other  se- 
quences that  could  handle  this  problem  —  it  obviously  occurs  whenever  vou  use  a  1 6- 
bit  counter  rather  than  the  8-bit  counter  that  we  have  used  in  most  of  the  examples. 

One  problem  is  that  there  is  no  instruction  that  loads  a  register  pair  using  the  address  in 
a  register  pair.  A  sequence  of  instructions  is  necessary  whenever  a  register  pair  must  be 
loaded  directly. 

It  may  be  useful  to  maintain  pointers  to  both  ends  of  the  queue  rather  than  just  to  its 
head.  The  data  structure  may  then  be  used  in  either  a  first-in,  first-out  manner  or  in  a 
last-in,  first-out  manner,  depending  on  whether  new  elements  are  added  to  the  head  or 
the  tail.  How  would  you  change  the  program  example  so  that  memory  locations  0044 
and  0045  contain  the  address  of  the  last  element  (tail)  of  the  queue? 

If  there  are  no  elements  in  the  queue,  the  program  clears  memory  locations  0040  and 
0041.  A  program  that  requested  an  element  from  the  queue  would  then  have  to  check 
those  memory  locations  to  see  if  its  request  had  been  satisfied.  Can  you  suggest  other 
ways  to  provide  this  information? 

8- Bit  Sort 

Purpose:  Sort  an  array  of  unsigned  binary  numbers  into  descending  order.  The  length 
of  the  array  is  in  memory  location  0040  and  the  array  itself  begins  in  memo- 
ry location  0041. 

Sample  Problem: 


(0040) 

06 

(0041) 

2A 

(0042) 

B5 

(0043) 

60 

(0044) 

3F 

(0045) 

D1 

(0046) 

19 

(0041) 

D1 

(0042) 

B5 

(0043) 

60 

(0044) 

3F 

(0046) 

2A 

(0046) 

19 

A  simple  sorting  technique  works  as  follows: 
Step  1)   Clear  a  flag  INTER. 

Step  2)    Examine  each  consecutive  pair  of  numbers  in  the  array.  If 

any  are  out  of  order,  exchange  them  and  set  INTER. 
Step  3)    If  INTER  =  1  after  the  entire  array  has  been  examined,  return  to  Step  1. 


SIMPLE 
SORTING 
ALGORITHM 
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INTER  will  be  set  if  any  consecutive  pair  of  numbers  is  out  of  order.  Therefore,  if  IN- 
TER =  0  at  the  end  of  a  pass  through  the  entire  array,  the  array  is  in  proper  order. 

This  sorting  method  is  referred  to  as  a  "bubble  sort"  It  is  an  easy  algorithm  to  imple- 
ment. However,  other  sorting  techniques  should  be  considered  when  sorting  long  lists 
where  speed  is  important.2 

The  technique  operates  as  follows  in  a  simple  case.  Let  us  assume  that  we  want  to  sort 
an  array  into  descending  order:  the  array  has  four  elements  —  12,  03,  15.  08. 

1st  Iteration: 

Step  1)    INTER  =  0 

Step  2)    Final  order  of  the  array  is: 
12 
15 
08 
03 

since  the  second  pair  (03.15)  is  exchanged  and  so  is  the  third  pair  (03,08). 
INTER  =  1. 

2nd  Iteration: 

Step  1)    INTER  =  0 

Step  2!    Final  order  of  the  array  is: 

15 

12 

08 

03 

since  the  first  pair  (12,15)  is  exchanged.  INTER  =  1. 
3rd  Iteration: 
Step  1)    INTER  =  0 

Step  2)    The  elements  are  already  in  order,  so  no  exchanges  are  necessary  and  INTER 
remains  zero. 
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Flowchart: 
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Source  Program 

SORT 


PASS1: 


CNT^ 


Object  Program: 


LD 

CO 

CLEAR  INTERCHANGE  FLAG 

LD 

HL,40H 

COUNT  =  LENGTH  OF  ARRAY 

LD 

B,(HL) 

DEC 

B 

NUMBER  OF  PAIRS  =  COUNT-1 

INC 

HL 

POINT  TO  START  OF  ARRAY 

LD 

A,(HL) 

GET  ELEMENT  FROM  ARRAY 

iNC 

HL 

CP 

(HL) 

IS  IT  LESS  THAN  NEXT  ELEMENT? 

JR 

NCCNT 

NO.  NO  INTERCHANGE  NECESSARY 

LD 

D,(HL) 

YES.  INTERCHANGE  ELEMENTS 

LD 

(HL),A 

DEC 

HL 

LD 

(HL).D 

INC 

HL 

LD 

C.I 

SET  INTERCHANGE  FLAG 

DJNZ 

PASS! 

DEC 

C 

WAS  INTERCHANGE  FLAG  SET? 

JR 

Z.SORT 

YES.  DO  ANOTHER  PASS 

HALT 

Memorv  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

OE 

SORT 

LD 

CO 

0001 

00 

0002 

21 

LD 

HL,40H 

0003 

40 

0004 

00 

0005 

46 

LD 

B,(HL) 

0006 

05 

DEC 

B 

0007 

23 

INC 

HL 

0008 

7E 

PASS1; 

LD 

A,(HL) 

0009 

23 

INC 

HL 

OOOA 

BE 

CP 

(HL) 

OOOB 

30 

JR 

NCCNT 

OOOC 

07 

OOOD 

56 

LD 

D.(HL) 

OOOE 

77 

LD 

(HL),A 

OOOF 

28 

DEC 

HL 

0010 

72 

LD 

(HL).D 

0011 

23 

INC 

HL 

0012 

OE 

LD 

CI 

0013 

01 

0014 

10 

CNT; 

DJNZ 

PASS1 

0015 

F2 

0016 

OD 

DEC 

C 

0017 

28 

JR 

Z.SORT 

0018 

E7 

0019 

76 

HALT 

The  case  where  two  elements  in  the  array  are  equal  is  very  important  here.  The  program 
should  not  perform  an  interchange  in  that  case,  since  that  interchange  would  occur  in 
every  pass.  The  result  would  be  that  every  pass  would  set  the  interchange  flag,  thus 
producing  an  endless  loop. 
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The  program  must  reduce  the  counter  by  1.  since  the  number  of  consecutive  pairs  I' 
one  less  than  the  number  of  elements  (the  last  element  has  no  successor).  Before  start 
tng  each  sorting  pass,  we  must  be  careful  to  reinitialize  the  counter,  pointer,  and  in 
terchange  flag. 

There  are  many  possible  minor  variations  on  this  program.  For  example,  we  could  use 
RES  0,C  and  SETO.C  to  clear  and  set  the  interchange  flag  instead  of  LD  CO  and  LD  C,1. 
We  could  also  use  the  sequence  MOV  B,C  followed  by  DJNZ  SORT  to  check  the  in- 
terchange flag. 

Note  that  Register  8  should  be  used  for  the  inner  counter,  since  that  counter  is  decre- 
mented most  frequently.  This  allows  us  to  take  maximum  advantage  of  the  DJNZ  in- 
struction. 

Indexing  would  be  a  convenient  way  to  perform  the  interchange  if  the  ZSO's  index 
registers  were  more  accessible.  Try  rewriting  the  program  so  as  to  use  one  of  the  index 
registers  and  compare  the  execution  time  and  memory  usage  of  the  rewritten  program 
to  those  of  the  original  program. 

Using  an  Ordered  Jump  Table 

Purpose:    Use  the  contents  of  memory  location  0040  as  an  index  to  a  jump  table  start- 


ing in  memory  location  0041 .  Each  entry  in  the  jump  table  contains  a  1 6-bit 
address  with  LSBs  in  the  first  word.  The  program  should  transfer  control  to 
the  address  with  the  appropriate  index;  that  is,  if  the  index  is  6,  the  pro- 
gram lumps  to  address  entry  #6  m  the  table.  Assume  that  the  table  has 
fewer  than  128  entries. 


(0040)  =  02 

(0041)  =  48 

(0042)  =  00 

(0043)  =  4C 

(0044)  =  00 

(0045)  =  50 

(0046)  =  00 

(0047)  =  54 

(0048)  =  00 

Result;     (PC)  =  0050,  since  that  is  entry  #2. 


Sample  Problem: 


(starting  from  zero)  in  the  jump  table. 


Flowchart: 


1 


index  =  (40}  x  2 
Base    =  41 


I 


JELEM  = 

Base  +  Index 


IPC)  = 

(JELEM)  UELEM  +  1) 
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The  last  box  results  in  a  transfer  of  control  to  the  address  obtained  from  the  table. 


Source  Program: 


LD 

HL.40H 

■PniNT  TO  INDFX 

LD 

A,(HL) 

■RFT  INDFX 

ADD 

A.A 

■nnURi  F  iNiDFX  FDR  ?-RYTF  TAR!  F 

LD 

E,A 

LD 

D,0 

;EXTEND  INDEX  TO  16  BITS 

INC 

HL 

:BASE  ADDRESS  OF  JUMP  TABLE 

ADD 

HLDE 

;INDEX  INTO  JUMP  TABLE 

LD 

E,(HL) 

:GET  LSB'S  OF  DESTINATION  ADDRESS 

INC 

HL 

LD 

D,(HL) 

'.GET  MSB'S  OF  DESTINATION  ADDRESS 

EX 

DE,HL 

JP 

(HL) 

:TRANSFER  CONTROL  TO  DESTINATION 

Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0000 

21 

LD 

HL,40H 

0001 

40 

0002 

00 

0003 

7E 

LD 

A,(HL) 

0004 

87 

ADD 

A.A 

0005 

5F 

LD 

E.A 

0006 

16 

LD 

D.O 

0007 

00 

0008 

23 

INC 

HL 

0009 

19 

ADD 

HLDE 

OOOA 

5E 

LD 

E,{HU 

OOOB 

23 

INC 

HL 

OOOC 

56 

LD 

D,(HL) 

OOOD 

EB 

EX 

DE,HL 

OOOE 

E9 

JP 

(HU 

Jump  tables  are  yery  useful  m  situations  where  one  of  several  routines  must  be 
selected.  Such  situations  arise  in  decoding  commands,  selecting  test  programs,  choos- 
ing alternate  methods,  or  selecting  an  I/O  configuration. 

The  jump  table  replaces  a  y/hole  series  of  conditional  jump  operations.  The  program 
that  accesses  the  jump  table  could  be  used  to  access  several  different  tables  merely  by 
changing  the  starting  address.^ 

The  data  must  be  multiplied  by  two  to  give  the  correct  index,  since  each  entry  in  the 
jump  table  is  a  two-byte  address. 

The  instruction  JP  (HL),  which  transfers  the  contents  of  Register 
Pair  HL  to  the  Program  Counter,  is  an  indirect  jump  that  is  very 
handy  in  jump  tables  and  monitor  programs.  Note  that  JP  (HL)  is  a 
Jump  instruction,  since  it  places  a  new  value  into  the  Program  Counter:  however,  it 
allows  us  to  place  a  variable  address  directly  into  the  Program  Counter.  All  of  the  Condi- 
tional Jump  instructions  (and  the  Call  instructions)  use  fixed  addresses.  The  only  Jump 
instructions  with  similar  flexibility  are  the  two-word  instructions  JP  (IX)  and  JP  (IY>. 

No  ending  operation  is  necessary,  since  JP  (HL)  transfers  control  to  the  address  ob- 
tained from  the  jump  table. 


INDIRECT 
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PROBLEMS 

1)    Remove  an  Entry  From  a  List 

Purpose:    Remove  the  contents  of  mennorv  location  0040  fronn  a  list  if  it  is  present. 

The  length  of  the  list  is  in  memory  location  0041  and  the  list  itself  begins  in 
memory  location  0042.  Move  the  entries  below  the  one  removed  up  one 
position  and  reduce  the  length  of  the  list  by  1. 

Sample  Problems: 

a.  (0040)  =  6B 

(0041)  =  04 

(0042)  =  37 

(0043)  =  61 

(0044)  =  28 

(0045)  =  ID 

Result:  No  change,  since  the  entry  is  not  in  the  list. 


(0040) 

6B 

(0041) 

04 

(0042) 

37 

(0043) 

6B 

(0044) 

28 

(0045) 

ID 

(0041) 

03 

(0042) 

37 

(0043) 

28 

(0044) 

ID 

The  entry  is  removed  from  the  list  and  the  ones  below  it  are  moved  up  one  position.  The 
length  of  the  list  is  reduced  by  1. 
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2)    Add  an  Entry  to  an  Ordered  List 

Purpose:  Place  the  contents  of  memory  location  0040  into  an  ordered  list  if  it  is  not 
already  there.  The  length  of  the  list  is  in  memory  location  0041,  and  the  list 
itself  begins  in  memory  location  0042,  which  consists  of  unsigned  binary 
numbers  in  increasing  order.  Place  the  new  entry  in  the  correct  position  in 
the  list,  adjust  the  elements  below  it  down,  and  increase  the  length  of  the 
list  by  1. 

Sample  Problems: 


(0040) 

_ 

6B 

(0041) 

04 

(0042) 

37 

(0043) 

55 

(0044) 

7D 

(0045) 

A1 

(0041) 

05 

(0044) 

6B 

(0045) 

7D 

(0046) 

A1 

(0040) 

6B 

(0041) 

04 

(0042) 

37 

(0043) 

55 

(0044) 

68 

(0045) 

A1 

Result:  No  change,  since  the  entry  is  already  in  the  list. 

3)    Add  an  Element  to  a  Queue 

Purpose:  Add  the  address  in  memon/  locations  0040  and  0041  (MSBs  in  0041)  to  a 
queue.  The  address  of  the  first  element  of  the  queue  is  in  memory  locations 
0042  and  0043  (MSBs  in  0043).  Each  element  in  the  queue  contains  either 
the  address  of  the  next  element  in  the  queue  or  zero  if  there  is  no  next  ele- 
ment; all  addresses  are  16  bits  long  with  the  most  significant  bits  in  the 
second  word  of  the  element.  The  new  element  goes  at  the  end  (tail)  of  the 
queue;  its  address  will  be  in  the  element  that  was  at  the  end  of  the  queue 
and  it  will  contain  zero  to  indicate  that  it  is  now  the  end  of  the  queue. 

Sample  Problem: 

new  element  to  be  added  to  queue 

pointer  to  head  of  queue 

last  element  in  queue 

old  last  element  points  to 
new  last  element 

new  last  element  in  queue 


(0040) 

4Di 

(0041) 

001 

(0042) 

46] 

(0043) 

001 

(0046) 

00| 

(0047) 

00! 

(0046) 

4D: 

(0047) 

00 : 

(004D) 

00 

(004E) 

00 

How  would  you  add  an  element  to  the  queue  if  memory  locations  0044  and  0045  con- 
tained the  address  of  the  tail  (last  element)  of  the  queue? 
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4)    16-Bit  Sort 

Purpose:    Sort  an  array  of  unsigned  16-bit  binary  numbers  into  descending  order.  The 
length  of  the  array  is  in  memory  location  0040  and  the  array  itself  begins  ir 
memory  location  0041.  Each  16-bit  number  is  stored  with  the  least  signifi 
cant  bits  In  the  first  word. 

Sample  Problem: 


!0040) 

03 

(0041) 

D1 

(0042) 

19 

(0043) 

60 

(0044) 

3F 

(0045) 

2A 

(0046) 

B5 

(0041) 

2A 

(0042) 

B5 

(0043) 

60 

(0044) 

3F 

(0045) 

D1 

(0046) 

19 

The  numbers  are  B52A,  3F60,  and  19D1 

5}    Using  a  Jump  Table  With  a  Key 

Purpose:  Use  the  contents  of  memory  location  0040  as  the  key  to  a  |ump  table  start- 
ing in  memory  location  0041.  Each  entry  in  the  jump  table  contains  an  8-bit 
key  value  followed  by  a  16-bit  address  (MSBs  m  second  word)  to  which  the 
program  should  transfer  control  if  the  key  is  equal  to  that  key  value. 

Sample  Problem: 

(0040)  =  38 

(0041)  =  32 

(0042)  =  4B 

(0043)  =  00 

(0044)  =  35 

(0045)  =  4D 

(0046)  =  00 

(0047)  =  38 

(0048)  =  4F 

(0049)  =  00 

Result:     (PC)     =  004F,  since  that  address  corresponds 
to  key  value  38. 

Try  writing  the  program  with  and  without  the  CPIR  instruction.  Can  you  think  of  a  way 
to  simplify  the  version  that  uses  the  CPIR  instruction?  Hint:  place  all  the  corresponding 
8-bit  words  into  separate  tables  so  that  the  program  only  has  to  add  1  to  the  table 
pointer  to  move  from  one  key  value  to  the  next.^ 
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Chapter  10 
SUBROUTINES 


None  of  the  examples  that  we  have  shown  so  far  is  typically  a  program  all  by  itself. 
Most  real  programs  perform  a  series  of  tasks,  many  of  which  may  be  the  same  or  may 
be  common  to  several  different  programs.  We  need  a  way  to  formulate  these  tasks  once 
and  make  the  formulations  conveniently  available  both  in  different  parts  of  the  current 
program  and  in  other  programs.   

The  standard  method  is  to  write  subroutines  that  perform  particu-    I  SUBROUTINE 
lar  tasks.  The  resulting  sequences  of  instructions  can  be  written    I  LIBRARY 
once,  tested  once,  and  then  used  repeatedly.  They  can  form  a 
subroutine  library  that  provides  documented  solutions  to  common  problems. 

Most  microprocessors  have  special  instructions  for  transferring 
control  to  subroutines  and  restoring  control  to  the  mam  pro- 
gram. We  often  refer  to  the  special  instruction  that  transfers 
control  to  a  subroutine  as  Call,  Jump-to-Subroutine,  Jump  and  Mark  Place,  or  Jump 
and  Link.  The  special  instruction  that  restores  control  to  the  main  program  is  usually 
called  Return.  On  the  Z80  microprocessor,  the  Call  instruction  (CALL)  saves  the  old 
value  of  the  Program  Counter  in  the  RAM  Stack  before  placing  the  starting  address  of 
the  subroutine  into  the  Program  Counter;  the  Return  instruction  (RET)  gets  the  old 
value  from  the  Stack  and  puts  it  back  in  the  Program  Counter.  The  effect  is  to  transfer 
program  control,  first  to  the  subroutine  and  then  back  to  the  main  program.  Clearly  the 
subroutine  may  itself  transfer  control  to  a  subroutine,  and  so  on. 

In  order  to  be  really  useful,  a  subroutine  must  be  general.  A  routine  that  can  perform 
only  a  specialized  task,  such  as  looking  for  a  particular  letter  in  an  input  string  of  fixed 
length,  will  not  be  very  useful.  If,  on  the  other  hand,  the  subroutine  can  look  for  any  let- 
ter in  strings  of  any  length,  it  will  be  far  more  helpful.  We  call  the  data  or  addresses  that 
the  subroutine  allows  to  vary  "parameters".  An  important  part  of  writing  subroutines  is 
deciding  which  variables  should  be  parameters.  ________ 

One  problem  IS  transferring  the  parameters  to  the  subroutine:  this  I  PASSING  I 
process  is  called  passing  parameters.  The  simplest  method  is  for  |  PARAMETERS  | 
the  main  program  to  place  the  parameters  into  registers.  Then  the 
subroutine  can  simply  assume  that  the  parameters  are  there.  Of  course,  this  technique 
is  limited  by  the  number  of  registers  that  are  available.  The  parameters  may,  however, 
be  addresses  as  well  as  data.  For  example,  a  sorting  routine  could  begin  with  the  start- 
ing address  of  an  array  in  Register  Pair  HL. 

Other  methods  are  necessary  when  there  are  more  parameters.  One  possibility  is  to  use 
the  Stack.  The  main  program  can  place  the  parameters  into  the  Stack  and  the 
subroutine  can  retrieve  them.  The  advantages  of  this  method  are  that  the  Stack  is  es- 
sentially unlimited  in  size,  and  that  data  in  the  Stack  is  not  lost  even  if  the  Stack  is  used 
again. 

The  disadvantages  are  that  few  Z80  instructions  use  the  Stack,  and  the  Call  instruction 
also  stores  the  return  address  in  the  Stack.  Another  method  is  to  use  an  area  of  memory 
for  parameters.  The  main  program  can  place  the  address  of  the  area  into  Register  Pair 
HL  or  into  one  of  the  index  registers  and  the  subroutine  can  retrieve  the  data  as  needed. 
However,  this  procedure  is  awkward  if  the  parameters  themselves  are  addresses. 


SUBROUTINE 
INSTRUCTIONS! 
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Sometimes  a  subroutine  must  have  special  characteristics.  A     I  RELOCATION  | 

subroutine  is  relocatable  if  it  can  be  placed  anywhere  in  memory. 
You  can  use  such  a  subroutine  easily,  regardless  of  the  placement  of  other  programs  or 
the  arrangement  of  the  memory.  .A  strictly  relocatable  program  can  use  no  absolute  ad- 
dresses; all  addresses  must  be  relative  to  the  start  of  the  program.  A  relocating  loader 
IS  necessary  to  place  the  program  in  memory  properly;  the  loader  will  start  the  program 
after  other  programs  and  will  add  the  starting  address  or  relocation  constant  to  all  ad- 
dresses in  the  program.   

A  subroutine  is  reentrant  if  it  can  be  interrupted  and  called  by  the     I  REENTRANT 
interrupting  program  and  still  give  the  correct  results  for  both  the     [  SUBROUTINE 
interrupting  and  interrupted  programs.  Reentrancy  is  important  for 
standard  subroutines  in  an  interrupt-based  system.  Otherwise  the  interrupt  service 
routines  cannot  use  the  standard  subroutines  without  causing  errors.  Microprocessor 
subroutines  are  easy  to  make  reentrant,  since  the  Call  instruction  uses  the  Stack  and 
that  procedure  is  automatically  reentrant.  The  only  remaining  requirement  is  that  the 
subroutine  use  the  registers  and  Stack  rather  than  fixed  memory  locations  for  tempor- 
ary storage.  This  is  a  bit  awkward,  but  usually  can  be  done  if  necessary. 

A  subroutine  is  recursive  if  It  calls  itself.  Such  a  subroutine  clearly  must  also  be  re- 
entrant. However,  recursive  subroutines  are  uncommon  in  microprocessor  applications. 

Most  programs  consist  of  a  main  program  and  several  subroutines.  This  is  advan- 
tageous because  you  can  use  proven  routines  and  debug  and  test  the  other  subroutines 
separately.  You  must,  however,  be  careful  to  use  the  subroutines  properly  and  remem- 
ber their  exact  effects  on  registers  and  memory  locations. 

SUBROUTINE  DOCUMENTATION 

Subroutine  listings  must  provide  enough  information  so  that 
users  need  not  examine  the  subroutine's  internal  structure. 
Among  the  necessary  specifications  are: 

•  A  description  of  the  purpose  of  the  subroutine. 

•  A  list  of  input  and  output  parameters. 

•  Registers  and  memory  locations  used. 

•  A  sample  case. 
If  these  guidelines  are  followed,  the  subroutine  will  be  easy  to  use. 
EXAMPLES 

It  is  important  to  note  that  the  following  examples  all  reserve  an  area  of  memory  for  the 
RAM  Stack.  If  the  monitor  in  your  microcomputer  establishes  such  an  area,  you  may  use 
it  instead.  If  you  wish  to  try  establishing  your  own  Stack  area,  remember  to  save  and 
restore  the  monitor's  Stack  Pointer  in  order  to  produce  a  proper  return  at  the  end  of 
your  main  program. 

To  save  the  monitor  Stack  Pointer,  use  the  instruction  LD  (addri.SP,  To  restore  the 
monitor  Stack  Pointer,  use  the  instruction  LD  SP,(addr).  Both  of  these  instructions  re- 
quire a  two-byte  operation  code  (ED  7B  for  loading  the  Stack  Pointer,  ED  73  for  storing 
It)  in  addition  to  the  two  bytes  of  address. 

We  have  used  address  0080  (hex)  as  the  starting  point  for  the  Stack.  You  may  have  to 
consistently  replace  that  address  with  one  more  suitable  for  your  configuration.  You 
should  consult  your  microcomputer's  manual  to  determine  the  required  changes. 
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Hex  to  ASCII 

Purpose:  Convert  the  contents  of  the  Aocunnulator  to  an  ASCII  character.  Place  the 
result  in  the  Accumulator.  Assume  that  the  Accumulator  contains  a  single 
hexadecimal  digit. 

Sample  Problems: 

a.  (A)  =  OC 
Result:  (A)  =  43  V 

b.  (A)  =  06 
Result;  lA)  =  36  '6' 

Flowchart: 


Source  Program: 

The  calling  program  starts  the  Stack  at  memory  location  0080,  gets  the  data  from 
memory  location  0040,  calls  the  conversion  subroutine,  and  stores  the  result  in  memory 
location  0041. 

ORG  0 

LD  SP,80H 

LD  A,(40H) 

CALL  ASDEC 

LD  (41 H),  A 
HALT 


The  subroutine  converts  a  hexadecimal  digit  to  ASCII. 


ORG 

20H 

ASDEC: 

CP 

10 

:IS  DATA  A  DECIMAL  DIGIT? 

JR 

CASCZ 

ADD 

A,'.A'-'9'-1 

;N0.  ADD  OFFSET  FOR  LETTERS 

ASCZ: 

ADD 

A,'0' 

;CONVERT  DATA  TO  ASCII 

RET 

:START  STACK  AT  LOCATION  0080 
:GET  DATA 

:  CONVERT  DATA  TO  ASCII 
:STORE  RESULT 
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Subroutine  Documentation: 


:  SUBROUTINE  ASDEC 

:  PURPOSE:  ASDEC  CONVERTS  A  HEXADECIMAL 
DIGIT  IN  THE  ACCUMULATOR  TO  AN 
ASCII  DIGIT  IN  THE  ACCUMULATOR 

;  INITIAL  CONDITIONS:  HEX  DIGIT  IN  A 

:  FINAL  CONDITIONS:  ASCII  CHARACTER  IN  A 

.  REGISTERS  USED:  A 

.  SAMPLE  CASE 


INITIAL  CONDITIONS:  6  IN  ACCUMULATOR 

FINAL  CONDITIONS:  ASCII  6  (HEX  36) 

IN  ACCUMULATOR 

Object  Program: 

Memorv  Address      Memory  Contents 

Instruction 

(Hex)  (Hex) 

(Mnemonic) 

1)    Calling  program 


0000 

31 

LD 

SP.SOH 

0001 

80 

0002 

00 

0003 

3A 

LD 

A,(40H) 

0004 

40 

0005 

00 

0006 

CD 

CALL 

ASDEC 

0007 

20 

0008 

00 

0009 

32 

LD 

(41H),A 

OOOA 

41 

OOOB 

00 

OOOC 

76 

HALT 

2)  Subroutine 

0020 

FE 

ASDEC: 

CP 

10 

0021 

OA 

0022 

38 

JR 

CASCZ 

0023 

02 

0024 

C6 

ADD 

A,'A'-'9'-1 

0025 

07 

0026 

C6 

ASCZ: 

ADD 

A/0' 

0027 

30 

0028 

C9 

RET 

The  instruction  LD  SP.SOH  starts  the  Stack  at  memorv  location  0080,  Remember  that 
the  Stack  grows  downward  (to  lower  addresses).  We  usually  place  the  Stack  at  the  high 
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end  of  RAM  (i.e..  the  highest  address)  so  that  it  will  not  interfere  with  other  temporary 
storage. 

The  Call  instruction  places  the  subroutine  starting  address  (0020  hex)  into  the  Program 
Counter  and  saves  the  old  Program  Counter  (0009  hex)  in  the  Stack.  The  procedure  is: 

STEP  1  — Decrement  Stack  Pointer,  save  IVlSBs  of  old  Program  Counter  in  Stack. 

STEP  2  —  Decrement  Stack  Pointer,  save  LSBs  of  old  Program  Counter  in  Stack. 

Note  that  the  Z80  Stack  Pointer  always  contains  the  address  of  the  last  occupied  Stack 
location. 

The  result  in  this  case  is: 

(007F)  =  00 
(007E)  =  09 
(SP)  =  007E 

The  value  that  is  saved  is  the  value  of  the  Program  Counter  after  the  processor  has 
fetched  the  entire  Call  instruction  from  memory.  Note  that  the  address  ends  up  stored 
lust  like  other  Z80  addresses,  with  the  least  significant  bits  in  the  lower  address. 

The  Return  instruction  loads  the  Program  Counter  with  the  contents  of  the  bottom  two 
memory  locations  in  the  Stack.  The  procedure  is: 

STEP  1  — Load  eight  bits  from  Stack  into  LSBs  of  Program  Counter.  Increment  Stack 
Pointer. 

STEP  2  —  Load  eight  bits  from  Stack  into  MSBs  of  Program  Counter.  Increment  Stack 
Pointer. 

The  result  in  this  case  is: 

(PC)  =  (007F)  and  (0070 

=  0009 
(SP)  =  0080 

This  subroutine  has  a  single  input  parameter  and  produces  a  single  result.  The  Ac- 
cumulator IS  the  obvious  place  to  put  both. 

The  calling  program  involves  three  steps:  placing  the  data  into  the  Accumulator,  call- 
ing the  subroutine,  and  storing  the  result.  The  overall  initialization  must  also  place  the 
Stack  in  the  appropriate  area  of  memory. 

The  subroutine  is  reentrant,  since  it  uses  no  data  memory;  it  is  relocatable,  since  the 
address  ASCZ  is  relative. 

Note  that  the  CALL  instruction  results  in  the  execution  of  four  or  five  instructions  taking 
36  or  38  clock  cycles.  A  subroutine  call  can  take  a  long  time  even  though  it  appears  to 
be  a  single  instruction  in  the  program. 

If  you  plan  to  use  the  Stack  for  parameters,  remember  that  CALL  places  the  return  ad- 
dress at  the  top  of  the  Stack.  You  can  increment  the  Stack  Pointer  twice  (INC  SP)  to  get 
past  the  return  address,  but  you  must  also  remember  to  adjust  the  Stack  Pointer  pro- 
perly before  returning.  You  can  also  move  the  Stack  Pointer  to  Registers  H  and  L  with 
the  sequence: 

LD  HLO 

ADD        HLSP  :MOVE  STACK  POINTER  TO  ADDRESS  REGISTER 

Now  you  can  use  implied  memory  addressing  with  H  and  L  to  access  data  in  the  Stack. 
Another  alternative  is  to  move  the  Stack  Pointer  to  an  index  register  (say  IX)  with  the  se- 
quence: 

LD  IX.O 

ADD        IX,SP  ; MOVE  STACK  POINTER  TO  INDEX  REGISTER 
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This  alternative  has  the  advantage  that  you  can  now  access  data  and  addresses  in  the 
Stack  with  indexed  offsets.  Furthermore,  Register  Pair  HL  is  immediatelv  available  for 
use  in  the  subroutine.  Note  that  you  can  use  the  instructions  LD  SP.HL  or  LD  SP.IX  to 
return  an  adjusted  value  to  the  Stack  Pointer. 

Length  of  a  String  of  Characters 

Purpose:  Determine  the  length  of  a  string  of  ASCII  characters.  The  starting  address  of 
the  string  is  m  Register  Pair  HL.  The  end  of  the  string  is  marked  by  a  carriage 
return  character  (CR,  hex  OD).  Place  the  length  of  the  string  (excluding  the 


carriage  return, 
Sample  Problems: 


Result: 


)  into  the  Accumulator. 


Result: 
Flowchart: 


(HL) 

0043 

(0043) 

OD 

(A) 

00 

(HL) 

0043 

(0043) 

52  -R' 

(0044) 

41  'A 

(0045) 

54  'T' 

(0046) 

48  'H' 

(0047) 

45 

(0048) 

52  'R' 

(0049) 

OD  CR 

(A) 

06 

c 


Pointer 

HL 

Count 

0 

10-6 


Source  Program; 


The  calling  program  starts  the  Stack  at  memory  location  0080,  gets  the  starting  address 
of  the  string  from  memory  locations  0040  and  0041.  calls  the  string  length  subroutine, 
and  stores  the  result  in  memory  location  0042. 


LD 

SP,80H 

START  STACK  AT  LOCATION  0080 

LD 

HL,(40H) 

GET  STARTING  ADDRESS  OF  STRING 

CALL 

STLEN 

DETERMINE  STRING  LENGTH 

LD 

(42H),A 

STORE  STRING  LENGTH 

HALT 

The  subroutine  determines  the  length  of  a  string  of  ASCII  characters  and 

length 

nto  the  Accumulator. 

ORG 

20H 

STLEN; 

LD 

B.O 

STRING  LENGTH  =  ZERO 

LD 

A.ODH 

GET  ASCII  CARRIAGE  RETURN 

CHKCR 

CP 

(HL) 

IS  CHARACTER  A  CARRIAGE  RETURN? 

JR 

Z,DONE 

YES,  END  OF  STRING 

INC 

B 

NO,  ADD  1  TO  STRING  LENGTH 

INC 

HL 

JR 

CHKCR 

DONE; 

LD 

A.B 

RET 

Subroutine  Documentation; 

;SUBROUTINE  STLEN 


:PURPOSE;  STLEN  DETERMINES  THE  LENGTH  OF  A 

STRING  (NUMBER  OF  CHARACTERS  BEFORE 
;       A  CARRIAGE  RETURN) 


:INITIAL  CONDITIONS;  STARTING  ADDRESS  OF 
STRING  IN  REGISTER  PAIR  HL 

;REGISTERS  USED;  A,B,H,L 

;SAMPLE  CASE; 

STARTING  CONDITIONS;  (HL)=  0043 

(0043)  =  35,  (0044)  =  46,  (0045)  =  OD 
FINAL  CONDITIONS;  (A)  =02 
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Object  Program: 


Memory  Address 
(Hex) 

Memory  Contents  Instruction 
(Hex)  (Mnemonic) 

1)     Prtilinn  nrnnram 

0000 

31  LD 

SP.80H 

0001 

80 

0002 

00 

0003 

2A  LD 

HL,(40H) 

0004 

40 

UUUD 

00 

0006 

CD  CALL 

STLEN 

0007 

20 

0008 

00 

0009 

32  LD 

(42H).A 

OOOA 

42 

OOOB 

00 

OOOC 

76  HALT 

2)  Subroutine 

0020 

06               STLEN:  LD 

8,0 

0021 

00 

0022 

3E  LD 

A,0DH 

0023 

OD 

0024 

BE               CHKCR:  CP 

(HL) 

UUZD 

28  JR 

Z,DONE 

0026 

04 

0027 

04  INC 

8 

0028 

23  INC 

HL 

0029 

18  JR 

CHKCR 

002A 

F9 

002B 

78               DONE:  LD 

A,B 

002C 

C9  RET 

The  calling  program  involves  four  steps:  initializing  the  Stack  Pointer,  placing  the  start- 
ing address  of  the  string  into  Register  Pair  HL,  calling  the  subroutine,  and  storing  the 

result. 

The  subroutine  is  reentrant,  since  it  does  not  change  the  contents  of  any  memorv  loca- 
tions. It  is  relocatable,  since  all  the  Jump  instructions  use  relative  addresses. 

The  subroutine  changes  Register  B  and  the  address  in  Register  Pair  HL  as  well  as  the 
Accumulator.  The  programmer  must  be  aware  that  data  previously  stored  in  Register  B 
and  the  address  previously  loaded  into  HL  will  be  lost:  the  subroutine  documentation 
must  describe  what  registers  are  used. 

An  alternative  to  destroving  register  contents  in  the  subroutine  is  to  save  them  in  the 
Stack  and  then  restore  them  before  returning.  This  approach  makes  the  calling  routine 
simpler,  but  costs  extra  time  and  memop/  (in  the  program  and  in  the  Stack). 

This  subroutine  has  a  single  input  parameter,  which  is  an  address.  The  best  way  to  pass 
this  parameter  is  through  a  register  pair  and,  since  the  HL  pair  is  certainly  the  most  flex- 
ible as  far  as  addressing  options  are  concerned,  it  is  the  obvious  choice. 

The  subroutine  contains  an  unconditional  Jump  instruction,  JR  CHKCR.  By  altering  the 
initial  conditions  prior  to  entering  the  subroutine's  loop,  can  you  eliminate  this  jump? 

If  the  terminating  character  were  not  always  an  ASCII  carriage  return,  we  could  make 
that  character  into  another  parameter.  Now  the  calling  program  would  have  to  place 
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the  terminating  character  into  the  Accumulator  and  the  starting  address  of  the  string 
into  Register  Pair  HL  before  calling  the  subroutine. 

One  way  to  pass  parameters  that  do  not  depend  on  variable  data  is  to  place  the  values 
in  program  memorY  immediately  after  the  Call  instruction.  You  can  use  the  old  Program 
Counter  (saved  at  the  top  of  the  Stack)  to  access  the  data,  but  you  must  adjust  its  value 
properly  before  returning  control  to  the  main  program.  For  example,  we  could  pass  the 
value  of  the  terminating  character  this  way.  The  main  program  and  subroutine  would 
be: 

Calling  program'. 


ORG 

0 

LD 

SP.80H 

:START  STACK  AT  LOCATION  0080 

LD 

(HL),40H 

;GET  STARTING  ADDRESS  OF  STRING 

CALL 

STLEN 

:DETERMINE  STRING  LENGTH 

DEFB 

.TERMINATOR  =  ASCII  PERIOD 

LD 

(42H),A 

:STORE  STRING  LENGTH 

HALT 

Subroutine: 


STLEN: 


CHKCR: 


ORG 

20H 

POP 

DE 

GET  START  OF  PARAMETER  LIST 

LD 

A,(DE) 

GET  TERMINATING  CHARACTER 

INC 

DE 

ADJUST  RETURN  ADDRESS 

PUSH 

DE 

LD 

B,0 

STRING  LENGTH  =  ZERO 

CP 

(HL) 

IS  CHARACTER  TERMINATOR? 

JR 

Z,DONE 

YES,  END  OF  STRING 

INC 

B 

NO,  ADD  1  TO  STRING  LENGTH 

INC 

HL 

JR 

CHKCR 

LD 

A,B 

RET 

DONE: 


This  subroutine  is  longer  and  uses  Register  Pair  DE,  but  the  calling  program  need  not 
load  the  terminating  character  into  a  register.  The  INC  DE  instruction  is  necessary  to 


force  a  return  to  the  next  instruction,  rather  than  to  the  parameter  list. 


PUSH  and  POP  transfer  the  contents  of  register  pairs  or  index  registers  to  and  from  the 
RAM  Stack.  The  eight  least  significant  bits  are  removed  first  and  stored  last  to  retain 
consistency  with  the  ZSO's  upside-down  method  of  storing  16-bit  addresses.  Remem- 
ber that  the  RAM  Stack  grows  downward  (to  lower  addresses). 

Add  Even  Parity  to  ASCII  Characters 

Purpose:  Add  even  parity  to  a  string  of  7-bit  ASCII  characters.  The  length  of  the  string 
IS  in  the  Accumulator  and  the  starting  address  of  the  string  is  in  Register  Pair 
HL.  Place  even  parity  in  the  most  significant  bit  of  each  character,  i.e.,  set  the 
most  significant  bit  to  1  if  that  makes  the  total  number  of  1  bits  in  the  wore 
even. 
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Sample  Problem: 


(A) 

— 

06 

(HL) 

0041 

(0041) 

O  1 
O  1 

(0042) 

■il 

if\r\A  rs\ 
tuU4d) 

QO 
OO 

(0044) 

OA 

o4 

(0045) 

Jb 

(0046) 

36 

(0041) 

Bl 

(0042) 

B2 

(0043) 

33 

(0044) 

84 

(0045) 

35 

(0046) 

36 
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Sourca  Program: 

The  calling  program  starts  the  Stack  at  memorv  location  0080,  sets  the  starting  address 
of  the  string  to  0041,  gets  the  string  length  from  memory  location  0030,  and  calls  the 
even  parity  subroutine. 


ORG 

0 

LD 

SP.SOH 

START  STACK  AT  LOCATION  0080 

LD 

HL,41H 

GET  STARTING  ADDRESS  OF  STRING 

LD 

A,(30H) 

GET  STRING  LENGTH 

CALL 

EPAR 

HALT 

The  subroutine  adds  even  parity  to  a  string  of  ASCII  characters. 

ORG 

20H 

EPAR: 

LD 

B.A 

LD 

C.10000000B 

;GET  PARITY  BIT  OF  1 

SETPR: 

LD 

.A,(HU 

'.GET  A  CHARACTER 

OR 

C 

:SET  PARITY  BIT  TO  1 

JP 

PO.CHCNT 

:IS  PARITY  NOW  EVEN? 

LD 

(HL).A 

■.YES,  SAVE  CHARACTER  WITH  EVEN 

CHCNT: 

INC 

HL 

DJNZ 

SETPR 

HALT 

Subroutine  Documentation: 


SUBROUTINE  EPAR 


PURPOSE:  EPAR  ADDS  EVEN  PARITY 
TO  A  STRING  OF  7-BIT  ASCII 
CHARACTERS 


INITIAL  CONDITIONS:  STARTING  ADDRESS 
OF  STRING  IN  HL,  LENGTH  OF  STRING 
IN  A 


FINAL  CONDITIONS:  EVEN  PARITY  IN 
MSB  OF  EACH  CHARACTER 


REGISTERS  USED:  A,B,C.H,L 


;SAMPLE  CASE: 

:    INITIAL  CONDITIONS:  (HU  =0041 

;       (Al  =  2.  (00411  =  32,  (0042)  =  33 

:       FINAL  CONDITIONS:  (0041)  =  B2,  (0042)  =  33 

This  subroutine  has  two  parameters,  an  address  and  a  number.  Register  Pair  HL  is  used 
to  pass  the  address  and  the  Accumulator  to  pass  the  number.  No  explicit  results  are 
returned,  since  the  subroutine  affects  only  the  MSB  of  each  character  in  the  string. 
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The  calling  program  must  place  the  starting  address  of  the  string  Into  Register  Pair  HL 
and  the  length  of  the  string  into  the  Accumulator  before  transferring  control  to  the 
subroutine. 

The  subroutine  changes  the  values  in  Registers  A,  H.  and  L  and  uses  Registers  B  and  C 
for  temporary  storage.  It  is  reentrant,  since  it  does  not  use  any  fixed  memory  locations 
for  temporary  storage. 

Object  Program:  


Memop/  Address      Memory  Contents  Instruction 
(Hex)  (Hex)  (Mnemonic) 


1)  Calling  program 

0000  31  LD  SP,80H 

0001  80 

0002  00 

0003  21  LD  HL.41H 

0004  41 

0005  00 

0006  3 A  LD  A,(30H) 

0007  30 

0008  00 

0009  CD  CALL  EPAR 
OOOA  20 

0008  00 

OOOC  76  HALT 

2)  Subroutine 

0020  47  EPAR:      LD  B.A 

0021  OE  LD  ClOOOOOOOB 

0022  80 

0023  7E  SETPR:     LD  A,(HL) 

0024  B1  OR  C 

0025  E2  JP  PO.CHCNT 

0026  29 

0027  00 

0028  77  LD  (HU.A 

0029  23  CHCNT;    INC  HL 
002A  10  DJNZ  SETPR 
002B  F7 

002C  C9  RET 


Pattern  Match 

Purpose:  Compare  two  strings  of  ASCII  characters  to  see  if  they  are  the  same.  The 
length  of  the  strings  is  in  the  Accumulator.  The  starting  address  of  one  string 
IS  in  Register  Pair  HL;  the  starting  address  of  the  other  is  in  Register  Pair  DE. 
If  the  two  strings  match,  clear  the  Accumulator;  otherwise,  set  the  Ac- 
cumulator to  FF  (hex). 
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Sample  Problems: 

a. 


Result: 


Result: 


Flowchart: 


lA) 

03 

IDE) 

50 

(HL) 

= 

60 

!0050) 

= 

43 

■c 

(0051) 

= 

41 

'A' 

(0052) 

54 

'T' 

(0060) 

= 

43 

■c 

(0061) 

= 

41 

■A' 

(0062) 

= 

54 

'T' 

(A) 

= 

0,  since 

(A) 

03 

(DE) 

_ 

50 

!HU 

= 

60 

(0050) 

= 

52 

■R' 

(0051) 

41 

■A' 

(0052) 

54 

T 

(0060) 

43 

■c 

(0061) 

41 

■A- 

(0062) 

54 

■T' 

(A) 

FF  (hex) 

^  start 

=  FF  (hex),  since  the  first  characters  differ. 


Pointer  1 

=  IDE) 

Pointer  2  ■ 

=  IHU 

Count  - 

=  (A) 

c 


Pointer  1  = 

Pointer  t  +  I 
Pointer  2  = 

Pointer  2  +  1 
Count  =   Count  -  1 

(Al  =  FF  (hexl 

Count  0  ^ 

jCVes 

(A)=0 
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Source  Program: 

The  calling  program  starts  the  Stack  at  memory  location  0080.  sets  the  starting  ad- 
dresses of  the  stnngs  to  0050  and  0060.  respectively,  gets  the  string  length  from 


memon/ 

location  0040,  calls  the  pattern  match  subroutine,  and  places  the 

memory 

location  0041. 

ORG 

0 

LD 

SP.80H 

START  STACK  AT  LOCATION  0080 

LD 

DE.60H 

GET  STARTING  ADDRESS  OF  STRING  1 

LD 

HL.50H 

GET  STARTING  ADDRESS  OF  STRING  2 

LD 

A,!40H) 

GET  STRING  LENGTH 

CALL 

PMTCH 

CHECK  FOR  MATCH 

LD 

(41  H),A 

SAVE  MATCH  INDICATOR 

HALT 

The  subroutine  determines  if  the  two  strings  are  the  same. 

ORG 

20H 

PMTCH: 

LD 

B.A 

COUNT  =  STRING  LENGTH 

LD 

COFFH 

MARK  =  FF  (HEX!  FOR  NO  MATCH 

CHCAR: 

LD 

A.(DE) 

GET  CHARACTER  FROM  STRING  1 

CP 

SHU 

IS  THERE  A  MATCH  WITH  STRING  2? 

JR 

NZ.DONE 

NO,  DONE  — STRINGS  D.O  NOT  MATCH 

INC 

DE 

INC 

HL 

DJNZ 

CHCAR 

LD 

CO 

MARK  =  ZERO,  STRINGS  MATCH 

DONE. 

LD 

A.C 

RET 

Subroutine  Documentation: 


;SUBROUTINE  PMTCH 

;PURPOSE:  PMTCH  DETERMINES  IF  TWO 
;    STRINGS  ARE  EQUIVALENT 

;INITIAL  CONDITIONS;  STARTING  ADDRESSES 

:   OF  STRINGS  IN  DE  AND  HL, 

;       LENGTH  OF  STRINGS  IN  ACCUMULATOR 

;F1NAL  CONDITIONS:  0  IN  A  IF 

;    STFIINGS  MATCH,  FF  IN  A  OTHERWISE 

;REGISTERS  USED:  A.B,D,E,H,L 

;SAMPLE  CASE: 

:    STARTING  CONDITIONS:  (HL)  =0050, 

(DE)  =  0060,  (A)  =  2 

(0050)  =36,  (0051)  =39 
:       (0060)  =36,  (0061)  =39 

:       FINAL  CONDITIONS:  (A)  =  0  SINCE  THE  STRINGS  MATCH 
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Object  Program; 


Memory  Address 

Memorv  Contents 

Instruction 

{Hex) 

(Hex) 

(Mnemonic) 

1)    Calling  program 

0000 

31 

1  n 

CD  QOM 

or  ,oun 

0001 

80 

0002 

00 

0003 

11 

LD 

0004 

60 

0005 

00 

0006 

21 

LD 

Mi  E=inH 
ni_,oun 

0007 

50 

0008 

00 

0009 

3A 

LD 

A,(40H) 

OOOA 

40 

OOOB 

00 

OOOC 

CD 

CALL 

PMTCH 

OOOD 

20 

OOOE 

00 

OOOF 

32 

LD 

141  H).  A 

0010 

41 

0011 

00 

0012 

76 

HALT 

2)  Subroutine 

0020 

47 

PMTCH: 

1  n 

R  A 

0021 

OE 

LD 

Q  OFFH 

0022 

FF 

0023 

1A 

CHCAR: 

LD 

A  (DF) 

rS,  SUEZ; 

0024 

BE 

rp 

(HI  ) 

0025 

20 

JR 

NZ.DONE 

0026 

06 

0027 

13 

INC 

DE 

0028 

23 

INC 

HL 

0029 

10 

DJNZ 

CHCAR 

002A 

F8 

002B 

OE 

LD 

CO 

002C 

00 

002D 

79 

DONE: 

LD 

A.C 

002E 

C9 

RET 

This  subroutine,  like  the  preceding  ones,  changes  all  of  the  flags.  You  should  generally 
assume  that  a  subroutine  call  changes  the  flags  unless  it  is  specifically  stated  other- 
wise. If  the  main  program  needs  the  old  flag  values  (for  later  checking),  it  must  save 
them  in  the  Stack  prior  to  calling  the  subroutine.  This  is  accomplished  w\th  the  PUSH 
AF  instruction. 


The  subroutine  is  reentrant  and  changes  all  the  main  registers  except  C. 

This  subroutine  has  three  parameters  —  the  two  starting  addresses  and  the  length  of 
the  strings.  These  parameters  use  five  general-purpose  registers. 
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Multiple-Precision  Addition 

Purpose:  Add  two  multiple-byte  binary  numbers.  The  length  of  the  numbers  in  bytes 
is  in  the  Accumulator.  The  starting  addresses  of  the  numbers  are  in  Register 
Pairs  DE  and  HL.  The  starting  address  of  the  result  is  in  Index  Register  IX.  All 
the  numbers  begin  with  the  least  significant  bits. 

Sample  Problem: 

(A)  =  04 

(DE)  =  51 

(HU  =  61 

(IX)  =  71 

(0051)  =  C3 

(0052)  =  A7 

(0053)  =  5B 

(0054)  =  2F 

(0061)  =  B8 

(0062)  =  35 

(0063)  =  DF 

(0064)  =  14 

Result:  =  (0071)  =7B 

(0072)  =  DD 

(0073)  =  3A 

(0074)  =  44 

i.e.  2F5BA7C3 
+  14DF35B8 
443ADD7B 

Flowchart: 


3 


Count 

=  (Al' 

Pointer  1 

=  (DE) 

Pointer  2 

=  IHU 

Pointer  3 

=  dxi' 

Carry 

=  01 

(Pointer  3)  - 

(Pointer  1) 
+  (Pointer  2) 
+  Carrv 


(This  step  also  produces  new  Carry) 


Pointer       Pointer1  +  1 
Pointer  2^  Pointer2  +  1 
Pointer  3=  Pointer3+i 
Count  =r  Count  -  1 


C 
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Source  Program: 

The  calling  program  starts  the  Stack  at  memory  location  0080,  sets  the  starting  ad- 
dresses of  the  various  numbers  to  0050.  0060.  and  0070,  respectively,  gets  the  length 
of  the  numbers  from  memory  location  0040,  and  calls  the  multiple-precision  addition 
subroutine. 


ORG 

0 

LD 

SP.80H 

:  START  STACK  AT  LOCATION  0080 

LD 

HL.50H 

:GET  STARTING  ADDRESS  OF  FIRST  NUMBER 

LD 

DE.60H 

:GET  STARTING  ADDRESS  OF  SECOND  NUMBER 

LD 

IX.70H 

;GET  STARTING  ADDRESS  OF  RESULT 

LD 

A,!40H) 

;GET  LENGTH  OF  NUMBERS  IN  BYTES 

CALL 

MPADD 

•,MULTIPLE-PRECISION  ADDITION 

HALT 

The  subroutine  performs  multiple-precision  binary  addition. 

ORG  20H 

MPADD:  LD  B,A 

AND  A 

ADDW:    LD  A,(DE; 

ADC  A,(HL) 

LD  (IX), A 

INC  DE 

INC  HL 

INC  IX 

DJNZ  ADDW 

RET 

Subroutine  Documentation: 
•.SUBROUTINE  MPADD 

:PURPOSE:  MPADD  ADDS  TWO 

;    MULTIPLE-BYTE  BINARY  NUMBERS 

;INITIAL  CONDITIONS:  STARTING  ADDRESSES 
,    OF  NUMBERS  IN  D  AND  E.  H  AND  L. 
;    STARTING  ADDRESS  OF  RESULT  IN  IX. 
:    LENGTH  OF  NUMBERS  IN  A 

;REGISTERS  USED:  A.B.D.E.H.LIX 

:SAMPLE  CASE: 

,    STARTING  CONDITIONS:  (HL)  =0050, 

(DE)  =  0060,  (IX)  =  0070,  (A)  =  2, 

(0050)  =  C3,  (0051)  =  A7.  (0060)  =  88.  (0061)  =  35 
:    FINAL  CONDITIONS:  (0070)  =  78.  (0071)  =  DD 


COUNT  =  LENGTH  OF  NUMBERS  IN  BYTES 
CLEAR  CARRY  TO  START 
GET  WORD  FROM  FIRST  NUMBER 
ADD  WORD  FROM  SECOND  NUMBER 
STORE  ONE  WORD  OF  RESULT 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

1)    Calling  program 

0000 

31 

LD 

SP.80H 

0001 

80 

0002 

00 

0003 

21 

LD 

HL,50H 

0004 

50 

0005 

00 

0006 

11 

LD 

DE,60H 

0007 

60 

0008 

00 

0009 

DD 

LU 

lA,  /Uii 

OOOA 

21 

OOOB 

70 

OOOC 

00 

OOOD 

3A 

LD 

A,(40H) 

OOOE 

40 

OOOF 

00 

0010 

CD 

CALL 

MPADD 

0011 

20 

0012 

00 

0013 

76 

HALT 

/)  Subroutine 

0020 

47 

LD 

B.A 

0021 

A7 

AND 

A 

0022 

1A 

LD 

A,(DE) 

0023 

8E 

ADC 

A,{HL) 

0024 

DD 

LD 

(IX)  A 

0025 

77 

0026 

00 

0027 

13 

INC 

DE 

0028 

23 

INC 

HL 

0029 

DD 

INC 

IX 

002A 

23 

002B 

10 

DJNZ 

ADDW 

002C 

F5 

002D 

C9 

RET 

We  use  Index  Register  IX  to  hold  the  result  address.  Try  changing  the  program  to  use 
Register  Pair  BC  for  this  purpose.  What  happens  to  the  counter? 

We  could  also  place  the  result  address  at  the  top  of  the  Stack.  The  instruction  EX 
(SPj.HL  exchanges  the  top  of  the  Stack  and  Register  Pair  HL.  Change  the  program  so 
that  it  uses  this  instruction,  but  remember  to  increment  all  three  pointers  after  each 
Iteration. 

This  subroutine  has  four  parameters  —  three  addresses  and  the  length  of  the  numbers. 
Six  8-bit  registers  and  the  16-bit  Index  Register  IX  are  used  for  passing  parameters. 
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PROBLEMS 

Note  that  you  are  to  write  both  a  calling  program  for  the  sample  problem  and  a  properly 
documented  subroutine. 

1)    ASCII  to  Hex 

Purpose:  Convert  the  contents  of  the  Accumulator  from  the  ASCII  representation  of  a 
hexadecimal  digit  to  the  4-bit  binary  representation  of  the  digit.  Place  the 
result  into  the  Accumulator. 

Sample  Problems: 

a.  (A)  =  43  'C 
Result:  (Al  =  OC 

b.  (A)  =  36  'e' 
Result:  (A)  =  06 

2}    Length  of  an  ASCII  Message 

Purpose:  Determine  the  length  of  an  ASCII-coded  message.  The  starting  address  of 
the  stnng  of  characters  in  which  the  message  is  located  is  in  Register  Pair 
HL.  The  message  itself  starts  with  an  ASCII  STX  character  (hex  02)  and  ends 
with  -ASCII  ETX  (hex  03).  Place  the  length  of  the  message  (the  number  of 
characters  between  the  STX  and  the  ETX)  into  the  Accumulator. 

Sample  Problem: 

(HL)  =  0041 

(0041)  =  49 

(0042)  =  02  STX 

(0043)  =  47  'G' 

(0044)  =  4F  '0' 

(0045)  =  03  ETX 

Result:        (A)  =  02 

3)    Check  Even  Parity  in  ASCII  Characters 

Purpose:  Check  the  even  panty  of  a  string  of  ASCII  characters.  The  length  of  the  string 
is  in  the  Accumulator  and  the  starting  address  of  the  string  is  in  Register  Pair 
HL.  If  the  parity  of  all  the  characters  in  the  string  is  correct,  clear  the  Ac- 
cumulator; otherwise,  set  the  Accumulator  to  FF  hex  (all  ones). 

Sample  Problems: 

a.  (A)  =  03 
(HL)  =  0042 

(0042)  =  B1 

(0043)  =  B2 

(0044)  =  33 

Result:        (A)  =  00,  since  all  the  characters  have  even  panty 

b.  (A)  =  03 
(HU  =  0042 

(0042)  =  Bl 

(0043)  =  86 

(0044)  =  33 

Result:        (A)  =  FF.  since  the  character  in  memory  location  0043 
does  not  have  even  parity 
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4)   String  Comparison 

Purpose:  Compare  two  strings  of  ASCII  characters  to  see  which  is  larger  (i.e.,  which 
would  follow  the  other  in  'alphabetical'  ordering). 

The  length  of  the  strings  is  in  the  Accumulator;  the  starting  address  of 
string  1  is  in  Register  Pair  HL  and  the  starting  address  of  string  2  is  in 
Register  Pair  DE.  If  string  1  is  larger  than  or  equal  to  string  2.  clear  the  Ac- 
cumulator; otherwise,  set  the  Accumulator  to  FF  hex  (all  ones). 

Sample  Problems: 


(A) 

03 

(DE) 

0060 

(HL) 

= 

0050 

(0050) 

= 

43 

'C 

(0051) 

41 

'A' 

(0052) 

54 

'T' 

(0062) 

42 

'B' 

(OObo) 

41 

'A' 

(0064) 

54 

'T' 

Result 

= 

(A) 

=  00, 

(Ai 

03 

(DE) 

0060 

(HL) 

= 

0050 

(0050) 

= 

44 

'D' 

(0051) 

= 

4F 

'0' 

(0052) 

47 

'G' 

(0060) 

44 

'D' 

(0061) 

4F 

'0' 

(0062) 

47 

'G' 

Result 

(A) 

=  00, 

(A) 

03 

(DE) 

0060 

(HL) 

0050 

(0050) 

43 

'C 

(0051) 

41 

'A' 

(0052) 

54 

T 

(0060) 

43 

■c 

(0061) 

55 

V 

(0062) 

54 

T 

Result 

(A) 

=  FF 

5)    Decimal  Subtraction 

Purpose:  Subtract  one  multiple-digit  decimal  (BCD)  number  from  another.  The  length 
of  the  numbers  (in  bytes)  is  in  the  Accumulator  and  the  starting  addresses  of 
the  numbers  are  in  Register  Pairs  DE  and  HL.  Subtract  the  number  with  the 
starting  address  in  HL  from  the  one  with  the  starting  address  in  DE.  The 
starting  address  of  the  result  is  in  Index  Register  IX.  All  the  numbers  begin 
with  the  least  significant  digits.  The  sign  of  the  result  is  returned  in  the  Ac- 
cumulator—  zero  if  the  result  is  positive,  FF  (hex)  if  it  is  negative. 
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Sample  Problem: 


(A)  =  04 

(DE)  =  0050 

!HL1  =  0060 

(IX)  =  0070 

(0050)  =  85 

(0051!  =  19 

(0052)  =  70 

(0053)  =  36 

(0060)  =  59 

(0061)  =  34 

(0062)  =  66 

(0063)  =  12 

Result:        (A)  =  00  (positive) 

(0070)  =  26 

(0071)  =  85 

(0072)  =  03 

(0073)  =  24 

I.e.,  36701985 

-  12663459 

+  24038526 
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Chapter  1 1 
INPUT/OUTPUT 


There  are  two  problems  in  the  design  of  input/output  sections:  one  is  how  to  interface 
peripherals  to  the  computer  and  transfer  data,  status,  and  control  signals:  the  other  is 
how  to  address  I/O  devfces  so  that  the  CPU  can  select  a  particular  one  for  a  data 
transfer.  Clearly,  the  first  problem  is  both  more  complex  and  more  interesting.  We  will 
therefore  discuss  the  interfacing  of  peripherals  here  and  leave  addressing  to  a  more 
hardware-oriented  book. 

In  theory,  the  transfer  of  data  to  or  from  an  I/O  device  is  similar  to 
the  transfer  of  data  to  or  from  memory.  In  fact,  we  can  consider  the 
memory  as  just  another  I/O  device.  The  memory  is,  however, 
special  for  the  following  reasons: 

1)  It  operates  at  almost  the  same  speed  as  the  processor. 

2)  It  uses  the  same  type  of  signals  as  the  CPU.  The  only  circuits  usually  needed  to  in- 
terface the  memory  to  the  CPU  are  drivers,  receivers,  and  level  translators. 

3)  It  requires  no  special  formats  or  any  control  signals  besides  a  Read/Write  pulse. 
4i    It  automatically  latches  data  sent  to  it. 

5)    Its  word  length  is  the  same  as  the  computer's. 

Most  I/O  devices  do  not  have  such  convenient  features.  They  may  operate  at  speeds 
much  slower  than  the  processor:  for  example,  a  teletypewriter  can  transfer  only  10 
characters  per  second,  while  a  slow  processor  can  transfer  10,000  characters  per  sec- 
ond. The  range  of  speeds  is  also  very  wide  —  sensors  may  provide  one  reading  per 
minute,  while  video  displays  or  floppy  disks  may  transfer  250,000  bits  per  second. 
Furthermore,  I/O  devices  may  require  continuous  signals  (motors  or  thermometers),  cur- 
rents rather  than  voltages  (teletypewriters),  or  voltages  at  far  different  levels  than  the 
signals  used  by  the  processor  (gas-discharge  displays).  I/O  devices  may  also  require 
special  formats,  protocols,  or  control  signals.  Their  word  lengths  may  be  much  shorter 
or  much  longer  than  the  word  length  of  the  computer.  These  variations  make  the 
design  of  I/O  sections  difficult  and  mean  that  each  peripheral  presents  its  own  special 
interfacing  problem. 

We  may,  however,  provide  a  general  description  of  devices  and  in- 
terfacing methods.  We  may  roughly  separate  devices  into  three 
categories,  based  on  their  data  rates: 

1)  Slow  devices  that  change  state  no  more  than  once  per  second.  Changing  their 
states  typically  requires  milliseconds  or  longer.  Such  devices  include  lighted  dis- 
plays, switches,  relays,  and  many  mechanical  sensors  and  actuators. 

2)  Medium-speed  devices  that  transfer  data  at  rates  of  1  to  10,000  bits  per  second. 
Such  devices  include  keyboards,  printers,  card  readers,  paper  tape  readers  and 
punches,  cassettes,  ordinary  communications  lines,  and  many  analog  data  acquisi- 
tion systems. 

3)  High-speed  devices  that  transfer  data  at  rates  of  over  10,000  bits  per  second.  Such 
devices  include  magnetic  tapes,  magnetic  disks,  high-speed  line  printers,  high- 
speed communications  lines,  and  video  displays. 
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The  interfacing  of  slow  devices  is  simple.  Few  control  signals  INTERFACINQ 
are  necessary  unless  the  devices  are  multiplexed,  i.e..  several       SLOW  DEVICES 
are  handled  from  one  port,  as  shown  in  Figures  11-1  to  11-4. 
input  data  from  slow  devices  need  not  be  latched,  since  it  remains  stable  for  a  long  time 
interval.  Output  data  must  of  course,  be  latched.  The  onlv  problems  with  input  are 
transitions  that  occur  while  the  computer  is  reading  the  data.  One-shots,  cross-coupled 
latches,  or  software  delay  routines  can  smooth  the  transitions. 

A  single  port  can  handle  several  slow  devices.  Figure  11-1  shows  a  demultiplexer  that 
automatically  directs  the  next  output  data  to  the  next  device  by  counting  output  opera- 
tions. Figure  11-2  shows  a  control  port  that  provides  select  inputs  to  a  demultiplexer. 
The  data  outputs  here  can  come  in  any  order,  but  an  additional  output  Instruction  is 
necessary  to  change  the  state  of  the  control  port.  Output  demultiplexers  are  commonly 
used  to  drive  several  displays  from  the  same  output  port.  Figures  11-3  and  11-4  show 
the  same  alternatives  for  an  input  multiplexer. 

Note  the  differences  between  input  and  output  with  slow  devices: 

II  Input  data  need  not  be  latched,  since  the  input  device  holds  the  data  for  an  enor- 
mous length  of  time  by  computer  standards.  Output  data  must  be  latched,  since 
the  output  device  will  not  respond  to  data  that  is  present  for  only  a  few  CPU  clock 
cycles. 

2)  Input  transitions  cause  problems  because  of  their  duration;  brief  output  transitions 
cause  no  problems  because  the  output  devices  (or  the  observers)  react  slowly. 

3)  The  major  constraints  on  input  are  reaction  time  and  responsiveness,  the  major 
constraints  on  output  are  response  time  and  observability. 

Medium-speed  devices  must  be  synchronized  in  some  way  to 
the  processor  clock.  The  CPU  cannot  simply  treat  these  devices 
as  if  they  held  their  data  forever  or  could  receive  data  at  any 
time.  Instead,  the  CPU  must  be  able  to  determine  when  a 
device  has  new  input  data  or  is  ready  to  receive  output  data.  It  must  also  have  a  way  of 
telling  a  device  that  new  output  data  is  available  or  that  the  previous  input  data  has 
been  accepted.  Note  that  the  peripheral  may  be  or  contain  another  processor. 

The  standard  unclocked  procedure  is  the  handshake.  Here  the  | HANDSHAKE  | 
sender  indicates  the  availability  of  data  to  the  receiver  and 
transfers  the  data:  the  receiver  completes  the  handshake  by  acknowledging  the  recep- 
tion of  the  data.  The  receiver  may  control  the  situation  by  initially  requesting  the  data  or 
by  indicating  its  readiness  to  accept  data;  the  sender  then  sends  the  data  and  com- 
pletes the  handshake  by  indicating  that  data  is  available,  in  either  case,  the  sender 
knows  that  the  transfer  has  been  completed  successfully  and  the  receiver  knows  when 
new  data  is  available. 
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The  Counter  controls  where  the  Demultiplexer  sends  the  data. 


Figure  11-1.  An  Output  Demultiplexer  Controlled  by  a  Counter 
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The  CPU  sends  control  information  to  the  Control  Port;  that  port  determines 
where  the  Demultiplexer  sends  the  data. 


Figure  1 1-2.  An  Output  Demuttlplexer  Controlled  by  a  Port 
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Figure  11-3.  An  Input  Multiplexer  Controlled  by  a  Counter 
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The  contnil  inftHination  wNch  the  CPU  sends  to  the  Cwitrol  Port  (with  an  output  operation) 
deterrrenes  virfnch  input  the  Midtqi^xer  routes  to  the  Data  PcKt. 


Figure  11-4.  An  Input  Multiplexer  Controlled  by  a  Port 


11-4 


Figures  1 1  -5  and  1 1  -6  show  typical  input  and  output  operations  using  the  handshake 
method.  The  procedure  whereby  the  CPU  checks  the  readiness  of  the  peripheral  before 
transferring  data  is  called  "polling"  Clearly,  polling  can  occupy  a  large  amount  of  pro- 
cessor time  if  there  are  many  I/O  devices.  There  are  several  ways  of  providing  the 
handshake  signals.  Among  these  are: 

•  Separate  dedicated  I/O  lines.  The  processor  may  handle  these  as  additional  I/O  ports 
or  through  special  lines  or  interrupts.  The  Z80  processor  does  not  have  serial  I/O  lines, 
but  the  Z80  Parallel  input/Output  device- (or  PIO)  does. 

•  Special  patterns  on  the  I/O  lines.  These  may  be  single  start  and  stop  bits  or  entire 
characters  or  groups  of  characters.  The  patterns  must  be  easy  to  distinguish  from 
background  noise  or  Inactive  states. 

We  often  call  a  separate  I/O  line  that  indicates  the  availability  of  IstrobeI 
data  or  the  occurrence  of  a  transfer  a  "strobe",  A  strobe  may,  for 
example,  clock  data  into  a  latch  or  fetch  data  from  a  buffer. 

Many  peripherals  transfer  data  at  regular  intervals;  i.e.,  synchronously.  Here  the  only 
problem  is  starting  the  process  by  lining  up  to  the  first  input  or  marking  the  first  output. 
In  some  cases,  the  peripheral  provides  a  clock  input  from  which  the  processor  can  ob- 
tain timing  information. 

Transmission  errors  are  a  problem  with  medium-speed  devices. 
Several  methods  can  lessen  the  likelihood  of  such  errors;  they 
include: 

•  Sampling  input  data  at  the  center  of  the  transmission  interval 
in  order  to  avoid  edge  effects;  that  is,  keep  away  from  the  edges  where  the  data  is 
changing. 

•  Sampling  each  input  several  times  and  using  majority  logic  such  as  best  three  out  of 
five.^ 

•  Generating  and  checking  parity;  an  extra  bit  is  used  that  makes  the  number  of  1  bits 
in  the  correct  data  even  or  odd. 

•  Using  other  error  detecting  and  correcting  codes  such  as  checksums,  LRC 
(longitudinal  redundancy  check),  and  CRC  (cyclic  redundancy  check).^ 

High-speed  devices  that  transfer  more  than  10,000  bits  per 
second  require  special  methods.  The  usual  technique  is  to  con- 
struct a  special-purpose  controller  that  transfers  data  directly 
between  the  memory  and  the  I/O  device.  This  process  is  called 
direct  memory  access  (DMA).  The  DMA  controller  must  force 
the  CPU  off  the  busses,  provide  addresses  and  control  signals 
to  the  memory,  and  transfer  the  data.  Such  a  controller  will  be 
fairly  complex,  typically  consisting  of  50  to  100  chips, 
although  LSI  devices  are  now  available.^  The  CPU  must  initially  load  the  Address  and 
Data  Counters  in  the  controller  so  that  the  controller  will  know  where  to  start  and  how 
much  to  transfer. 
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b)    CPU  reads  Data  Ready  signal  from  1/0  section  {this  may  be  a  hardware  interrupt  connection). 
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d)   CPU  sends  Input  Acknowledge  signal  to  I/O  section,  which  then  provides  input  Acknowledge  signal 
to  Peripheral  (this  may  be  a  hardware  connection). 


Figure  1 1-5.  An  Input  Handshake 
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c)   CPU  sends  data  to  Penpheral. 
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d)   CPU  sends  Output  Ready  signal  to  Penpheral  (this  may  be  a  hardware  connection). 


Figure  11-6.  An  Output  Handshake 
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TIMING  INTERVALS  (DELAYS) 


One  problem  that  we  will  face  throughout  the  discussion  of  in- 
put/output is  the  generation  of  timing  intervals  with  specific 
lengths.  Such  intervals  are  necessary  to  debounce  mechanical 
switches  (to  smooth  their  irregular  transitions),  to  provide  pulses 
with  specified  lengths  and  frequencies  for  displays,  and  to  provide  timing  for  devices 
that  transfer  data  regularly  Ifor  example,  a  teletypewriter  that  sends  or  receives  one  bit 
even/  9.1  ms). 

We  can  produce  timing  intervals  in  several  ways: 

1)  In  hardware  with  one-shots  or  monostable  multivibrators. 
These  devices  produce  a  single  pulse  of  fixed  duration  in 
response  to  a  pulse  input. 

2)  In  a  combination  of  hardware  and  software  with  a  flexible  pro- 
grammable timer  such  as  the  Z80  Counter-Timer  Circuit  ior 
CTC)  for  Z80  based  microcomputers,  as  described  in  An  Introduction  to  Microcom- 
puters: Volume  2  —  Some  Real  Microprocessors.  The  CTC  can  provide  timing  in- 
tervals of  various  lengths  with  a  variety  of  starting  and  ending  conditions. 

3)  In  software  with  delay  routines.  These  routines  use  the  processor  as  a  counter.  This 
is  possible  since  the  processor  has  a  stable  clock  reference,  but  it  clearly  under-util- 
izes  the  processor.  However,  delay  routines  require  no  additional  hardware  and 
often  use  processor  time  that  would  othenwise  be  wasted. 

The  choice  among  these  three  methods  depends  on  your  applica- 
tion. The  software  method  is  inexpensive  but  may  overburden  the 
processor.  The  programmable  timers  are  relatively  expensive,  but 
are  easy  to  interface  and  may  be  able  to  handle  many  complex 
timing  tasks. 

DELAY  ROUTINES 

A  simple  delay  routine  works  as  follows: 
Step  1)    Load  a  register  with  a  specified  value. 
Step  2)    Decrement  the  register. 

Step  3)    If  the  result  of  Step  2  is  not  zero,  repeat  Step  2. 

This  routine  does  nothing  except  use  time.  The  amount  of  time  used  depends  upon  the 
execution  time  of  the  various  instructions.  The  maximum  length  of  the  delay  is  limited 
by  the  size  of  the  register:  however,  the  entire  routine  can  be  placed  inside  a  similar 
routine  that  uses  another  register,  and  so  on. 

The  following  example  uses  Register  C  and  the  Accumulator  to 
provide  delays  as  long  as  255  ms.  The  choice  of  registers  is  ar- 
bitran/.  You  may,  in  fact,  find  the  use  of  a  register  pair  (e.g.,  BC) 
more  convenient.  A  PUSH  BC  instruction  at  the  start  of  the 
delay  routine  and  a  POP  BC  at  the  end  will  result  in  a  routine  that  does  not  affect  any 
registers  at  all.  Such  a  routine  is  said  to  be  "transparent"  to  the  calling  program.  Note 
that  the  PUSH  and  POP  instructions  must  be  included  in  the  time  budget. 
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EXAMPLE 

Delay  Program  Using  Accumulator 

Purpose:  The  program  provides  a  delay  of  1  ms  times  the  contents  of  Accumulator. 
Flowchart: 

I         Start  J 


i 


Count 

=  MSCNT 

Count 

=  Count  -  t 

The  value  of  MSCNT  depends  on  the  speed  of  the  CPU  and  the  memorv  cycle. 
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Source  Program: 

DELAY;  LD 
DLYl;  DEC 
JR 
DEC 
JR 
RET 

Object  Program: 


C.MSCNT 
C 

NZ,DLY1 
A 

NZ.DELAY 


GET  COUNT  FOR  1  MS  DELAY 

COUNT  =  COUNT  -1 

CONTINUE  UNTIL  COUNT  =  ZERO 

DECREMENT  NUMBER  OF  REMAINING  MS 

CONTINUE  UNTIL  NUMBER  OF  MS  =  ZERO 


Memorv  Location 
(Hex) 

Memorv  Contents 
(Hex) 

Instruction 
(Mnemonic) 

0030 

OE 

DELAY: 

LD 

CMSCNT 

0031 

MSCNT 

0032 

OD 

DLYl: 

DEC 

C 

0033 

20 

JR 

NZ,DLY1 

0034 

FD 

0035 

3D 

DEC 

A 

0036 

20 

JR 

NZ.DELAY 

0037 

F8 

0038 

C9 

RET 

Time  Budget: 


Instruction 

Number  of  Times  Executed 

LD 

C.MSCNT 

(A) 

DEC 

C 

(A)  X  MSCNT 

JR 

NZ,DLY1 

(A)  X  MSCNT 

DEC 

A 

(A) 

JR 

NZ.DELAY 

(A) 

RET 

The  total  time  used  should  be  (A)  x  1  ms. 

If  the  memory  is  operating  at  full  speed,  the 

instructions  require  the  following  numbers  of  clock  cycles. 

LD 

C.MSCNT 

7 

DEC 

C  or  DEC  A 

4 

JR 

NZ 

7  or  12 

RET 

10 

The  alternative  times  for  JR  are  for  the  condition  being  met  (12)  or  not  met  (7). 
Ignoring  the  CALL  and  RET  instructions  (which  occur  only  once),  the  program  takes: 
(A)  X  (7+16  X  MSCNT  -  5  +  16)  -  5 

clock  cycles.  The  -5's  are  caused  by  the  fact  that  JR  takes  less  time  during  the  final 
Iteration  when  the  condition  is  not  met. 

So,  to  make  the  delay  1  ms. 

13+  16  X  MSCNT  =  Nr, 


where  Nq  is  the  number  of  clock  cycles  per  millisecond.  At  the 
standard  4  MHz  Z80  clock  rate,  Ng  =  4000.  so: 

1 6  X  MSCNT  =  3987 

I  MSCNT  =  249  (hex  F9)  at  a  Z80  clock  rate  of  4  MHz  I 


Z80  DELAY 
LOOP 

CONSTANT 
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SIMPLE  I/O  DEVICES 


PiO  REQISTEBS 
AND 

CONTROL  LINES 


THE  Z80  PARALLEL  INPUT/OUTPUT  CIRCUIT  (PIO) 

The  key  element  in  mostZSO  input/output  sections  is  theZSO  Parallel  Input/Output  Cir- 
cuit or  PIO.  This  device  combines  latches,  buffers,  flip-flops,  and  other  logic  circuits 
needed  for  handshaking  and  other  simple  interfacing  techniques.  The  PIO  contains 
many  logic  connections,  certain  sets  of  which  can  be  selected  according  to  the  con- 
tents of  programmable  registers.  Thus,  the  designer  has  the  equivalent  of  a  Circuit 
Designer's  Casebook  under  his  control.  The  initialization  phase  of  the  program  places 
the  appropriate  values  into  registers  to  select  the  required  logic  connections.  .An  in- 
put/output section  based  on  PIOs  can  handle  manv  different  applications,  and  changes 
or  corrections  can  be  made  in  software  rather  than  by  rewiring. 

Figure  1 1  -7  is  the  block  diagram  of  a  PIO.  The  device  contains  two  nearly  identical  8-bit 
ports  —  A,  which  is  usually  an  input  port,  and  B,  which  is  usually  an  output  port.  Each 
port  (see  Figure  11-8)  contains: 

•  An  8-bit  Data  Output  register 

•  An  8-bit  Data  Input  register 

■  A  2-bit  Mode  Control  register,  which  indicates  whether  the 
port  is  in  an  output,  input,  bidirectional,  or  control  mode 

•  An  8-bit  Input/Output  Control  register,  which  determines  whether  the  corresponding 
data  pins  are  inputs  (1)  or  outputs  (0)  in  the  control  mode 

•  Two  control  lines  (STB  and  RDY)  that  are  configured  by  the  Mods  Control  register. 
These  lines  can  be  used  for  the  handshaking  signals  shown  in  Figures  1 1  -5  and  1 1  -6. 

•  A  2-bit  Mask  Control  register  (used  only  in  the  control  mode)  that  determines  the  ac- 
tive polarity  of  the  inputs  and  whether  they  will  be  logically  ORed  or  ANDed  to  form 
an  interrupt  signal 

•  -An  8-bit  Mask  register  (used  only  in  the  control  mode)  that  determines  which  port 
lines  will  be  monitored  to  form  the  interrupt  signal 

•  An  8-bit  Vector  Address  register  used  with  the  interrupt  system 

For  now,  we  will  be  concerned  only  with  the  Mode  Control  registers,  the  Input/Output 
Control  registers,  and  the  control  lines.  We  will  discuss  the  interrupt-related  features  of 
the  PIO  in  Chapter  12. 

The  meanings  of  the  bits  in  the  various  control  and  mask  registers  are  related  to  the  un- 
derlying hardware  and  are  entirely  arbitrary  as  far  as  the  assembly  language  program- 
mer is  concerned.  You  must  either  memorize  them  or  look  them  up  in  this  chapter  and 
in  Chapter  12. 


Each  PIO  occupies  four  input  port  addresses  and  four  output  port  PIO 
addresses.  The  B/A  SEL  (Port  B  or  A  select)  and  C/D  SEL  (Control  [ADDRESSES 
or  Data  Select)  lines  choose  one  of  the  four  ports  as  described  in 
Table  11-1.  Most  often,  designers  attach  addresS  bit  Aq  to  the  B/A  SEL  input  and  ad- 
dress bit  -A-]  to  the  C/D  SEL  input.  The  PIO  then  occupies  four  consecutive  port  ad- 
dresses as  described  in  the  last  column  of  Table  11-1. 

Clearly  there  are  far  more  internal  control  registers  than  there  are  port  addresses  for 
them.  In  fact,  all  the  control  registers  for  each  port  occupy  one  address  according  to  the 
C/D  SEL  connection.  So  some  of  the  data  bits  sent  to  a  control  register  are  actually  used 
for  addressing  purposes.  Note  the  following  situations  (see  Table  1 1-2): 

Do  =  0  means  that  the  remaining  data  bits  are  loaded  into  the  Interrupt  Vector  register. 
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+  5V   QND  * 


t     f  f 


Penpherai 
Interface 


Figure  11-7  PIO  Block  Diagram 
(Courtesy  of  Zilog) 
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STROBE  /Lines 
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Figure  11-8.  Block  Diagram  of  PIO  Port 
(Courtesy  of  Zilog) 
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Table  11-1.  PIO  Addresses 


CONTROL  OR 

PORT  B  OR  A 

REGISTER 

PORT  ADDRESS 

DATA  SELECT 

SELECT 

ADDRESSED 

{STARTING  WITH  PIOADD) 

0 

0 

Data  Register  A 

PIOADD 

0 

1 

Data  Register  B 

PIOADD+1 

1 

0 

Control  A 

PIOADD+2 

1 

1 

Control  B 

PIOADD+3 

The  port  addresses  assume  that  C/D  SEL  is  tied  to  Ai  and  B/A  SEL  to  Aq. 

Table  1 1-2.  Addressing  of  PIO  Control  Registers 


REGISTER 

ADDRESSING 

MODE  CONTROL 
INPUT/OUTPUT  CONTROL 

MASK  CONTROL  REGISTER 
INTERRUPT  MASK  REGISTER 

INTERRUPT  ENABLE 
INTERRUPT  VECTOR 

□3  =  D2  =  Di  =  Do  =  1 

NEXT  WORD  AFTER  MODE  CONTROL 

SETS  MODE  3 

D3  =  0,  D2  =  Di  =Do  =  1 

NEXT  WORD  AFTER  MASK  CONTROL 

REGISTER  ACCESSED  WITH  D4  =  1 

D3  =  D2  =  0,  Di  =  Do  =  1 

Do  =  1 

D3  =  0,  D2  =  Di  =  Do  =  1  means  that  the  remaining  data  bits  are  loaded  into  the  Mask 
Control  register.  If  04  =  1,  the  next  control  word  is  loaded  into  the  Interrupt  Mask 
register.  Interrupts  can  be  enabled  or  disabled  with  D3  =  D2  =  0,  Di  =  Dq  =  1. 

D3  =  D2  =  Di  =  Do  =  1  means  that  the  remaining  data  bits  are  loaded  into  the  Mode 
Control  register.  If  D7  =  Ds  =  1  (control  mode),  the  next  control  word  is  loaded  into  the 
Input/Output  Control  register. 

This  sharing  of  an  external  address  means  that: 

1)  The  programmer  must  be  very  careful  of  the  order  of  operations.  The  meaning  of  a 
particular  Output  instruction  depends  on  the  sequence  in  which  it  occurs. 

2)  The  programmer  should  document  the  PIO  configuration  in  detail.  The  device  is 
complex,  and  a  reader  is  unlikely  to  be  able  to  make  much  sense  out  of  the  se- 
quence of  operations  that  configures  it. 

We  should  note  that  one  usually  configures  the  control  registers  of  the  PIO  just  once  in 
the  initialization  phase  of  the  program.  The  rest  of  the  program  then  uses  only  the  PIO 
data  registers. 
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PIO  MODE  CONTROL 


The  mode  of  operation  of  a  PIO  is  established  by  writing  a  control  PIO 
word  to  the  PIO  in  the  form  shown  in  Figure  11-1.  Table  11-3  de-  MODES 
scribes  the  meanings  of  the  various  modes  and  the  control  words 
required  to  establish  them.  Note  that  bits  D5  and  D4  are  not  used.  When  power  is 
turned  on.  the  PIO  comes  up  in  mode  1  (input). 

We  may  summarize  the  modes  as  follows: 

1)  Mode  0  — OUTPUT 

Writing  data  into  the  port  Output  register  latches  the  data  and 
causes  it  to  appear  on  the  port  Data  Bus.  The  READY  (RDYi 
line  goes  high  to  indicate  Data  Ready;  it  remains  high  until  the 
peripheral  sends  a  rising  edge  on  the  STROBE  (STB)  line  to  indicate  Data  Accepted 
or  Device  Ready.  The  rising  edge  of  STB  causes  an  interrupt  if  the  interrupt  has 
been  enabled. 

2)  Model— INPUT 
The  peripheral  latches  data  into  the  port  Input  register  using 
the  STROBE  signal.  The  rising  edge  of  STB  causes  an  interrupt 
(if  enabled)  and  deactivates  RDY.  When  the  CPU  reads  the 
data,  RDY  goes  high  to  indicate  Data  Accepted  or  Input  Register  Empty.  Note  that 
the  peripheral  can  strobe  data  into  the  register  regardless  of  the  state  of  RDY.  The 
programmer  must  thus  handle  the  problem  of  overrun,  i.e.,  new  data  being  placed 
into  the  register  before  the  old  data  Is  read. 

3)  Mode  2  —  BIDIRECTIONAL 
This  mode  uses  all  four  handshake  lines,  so  It  Is  allowed 
only  on  Port  A.  The  Port  A  RDY  and  STB  signals  are  used 
for  output  control  and  the  Port  B  RDY  and  STB  signals  are 
used  for  Input  control.  The  only  difference  between  this  mode  and  a  combination  of 
modes  0  and  1  is  that  data  from  the  Port  .A  Output  register  is  enabled  onto  the  port 
Data  Bus  only  when  A  STB  is  active.  This  allows  the  Port  A  bus  to  be  used  bidirec- 
tionally  under  the  control  of  A  STB  (Output  Data  Request)  and  B  STB  (Input  Data 
Available).  Note  that  the  B  side  control  signals  are  governed  by  Input  Register  A  in 
this  mode. 

4)  Mode  3  — CONTROL 
This  mode  does  not  use  the  RDY  and  STB  signals.  It  is  In- 
tended for  status  and  control  applications  in  which  each 
bit  has  an  individual  meaning.  When  mode  3  is  selected, 
the  next  control  word  sent  to  the  PIO  defines  the  directions 
of  the  port  data  bits  (Figure  11-9).  A  '1'  in  a  bit  position 
makes  the  corresponding  bus  line  an  input,  while  a  '0' 
makes  It  an  output. 


PIO 

OUTPUT 
MODE 


PIO 

BIDIRECTIONAI. 
MODE 


PIO 

CONTROL 
MODE 


PIO 

DIRECTIONS  IN 
CONTROL  MODE 
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Set  Mode 


Ml 

MO 

Mode 

0 

0 

Output 

0 

1 

Input 

1 

0 

Bidirectional 

1 

1 

Bit  Control 

E 


MO 

X 

X 

1 

1 

1 

] 


When  selecting  Mode  3,  the  next  word  must 
set  the  I/O  Register; 


|l/07  1/06  l/05jl/04jl/03  l/02jl/01  [l/Oo| 


I/O  =  1  Sets  bit  to  Input 
1/0=0  Sets  bit  to  Output 


PIO  Mode 

Meaning 

Control  Word 

(Binary)  (Hex) 

0 

Output 

00001111  OF 

1 

Input 

01001111  4F 

2 

Bidirectional 

10001111  8F 

3 

Control 

11001111  CF 

Note  that  bits  4  and  5  are  not  used  and  could 
have  anv  values. 


Figure  1 1-9.  Mode  Control  for  the  Z80  PIO 


FEATURES  OF 
PIO  MODES 


Note  the  following  features  of  the  PIO  modes: 

1)  In  modes  0,1,  and  2  the  peripheral  indicates  Data  Ready, 
Device  Ready,  or  Data  Accepted  with  a  rising  edge  on  the 

STB  line.  This  edge  also  causes  an  interrupt  if  the  interrupt  is  enabled. 

2)  In  modes  0,1,  and  2  the  PIO  indicates  Data  Ready,  Input  Buffer  Empty,  or  Data  Ac- 
cepted by  sending  RDY  high.  This  signal  remains  high  until  the  next  rising  edge  on 
STB. 

31  Only  Port  A  can  be  used  bidirectionally.  If  Port  .A  is  in  mode  2  (bidirectional).  Port  B 
can  only  be  in  mode  3  (control)  since  no  handshake  lines  are  available. 

4)  The  control  mode  (3)  is  the  only  mode  in  which  the  Input/Output  Control  register  is 
used.  Otherwise,  the  entire  port  is  used  for  either  input  or  output. 

5)  There  is  noway  for  the  processor  to  determine  if  a  pulse  has  occurred  on  STB  if  in- 
terrupts are  not  being  used.  The  PIO  is  designed  for  use  in  interrupt-driven  rather 
than  polling  systems  (see  Chapter  12).  STB  should  be  tied  low  if  it  is  not  being 
used. 

6)  The  processor  cannot  directly  control  the  RDY  lines.  The  RDY  line  on  a  port  goes 
high  when  data  is  transferred  to  or  from  the  port  and  goes  low  on  the  rising  edge  of 
STB. 

7)  The  contents  of  the  data  Output  register  can  be  read  if  the  port  is  in  the  output  or 
bidirectional  mode.  If  the  port  is  in  the  control  mode,  the  output  register  data  from 
the  lines  assigned  as  outputs  can  be  read.  The  contents  of  control  registers  cannot 
be  read. 

8)  If  the  RDY  output  is  tied  to  the  STB  input  on  a  port  in  the  output  mode,  RDY  will  go 
high  for  one  clock  period  after  each  output  operation.  This  brief  pulse  can  be  used 
to  multiplex  displays  as  shown  in  Figure  11-1. 
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CONFIGURING  THE  PIO 

The  program  must  select  the  logic  connections  in  the  PIO  before  transferring  data  to  or 
from  it.  This  selection  (or  configuration)  is  usually  part  of  the  startup  routine.  Note  that 
the  PIO  comes  up  in  the  input  mode  with  all  interrupts  disabled  and  inhibited  and  con- 
trol signals  deactivated  !low)  when  power  is  turned  on.  However,  the  PIO  does  not  have 
a  RESET  input  and  does  not  necessarily  return  to  the  reset  state  when  the  CPU  is  reset. 
The  steps  in  PIO  configuration  are: 

1)  Establish  the  mode  of  operation  by  writing  the  ap-  STEPS  IN 
propriate  control  words  to  the  Mode  Control  register.  CONFIGURING  A 

Interrupt  control  as  well  as  I/O  mode  information  may  PIO 
have  to  be  sent. 

2)  If  in  mode  3,  establish  the  directions  of  the  I/O  pins  by  writing  a  control  word  to  the 
Input/Output  Control  register.  This  word  must  follow  the  control  word  that  selected 
mode  3. 

Let  us  now  look  at  some  examples  of  configuring  a  PIO  without  interrupts; 
1)    OUTPUT  PORT 


LD 
OUT 


A.OOOOmiB 
!PIOCRB),A 


2)    INPUT  PORT 

LD  A.01001111B 

OUT  (PIOCRAi.A 

3) 


:MAKE  PORT  B  OUTPUT 


:MAKE  PORT  A  INPUT 


BIDIRECTIONAL  PORT 

LD  A.IOOOIIIIB     :MAKE  PORT  A  BIDIRECTIONAL 

OUT  (PIOCRAI.A 

Remember  that  only  Port  A  can  be  bidirectional  and  that  Port  B  must  then  be  a  control 
port. 

4)  CONTROL  PORT,  ALL  INPUTS 

LD  A.11001111B 
OUT  (PIOCRAI.A 
LD  A.OFFH 
OUT  (PIOCRA),A 

5)  CONTROL  PORT,  ALL  OUTPUTS 

LD  A,11001111B 

OUT  !PIOCRB),A 

SUB  A 

OUT  (PIOCRB),A 

6)  CONTROL  PORT.  LINES  1,5.6  INPUTS;  LINES  0,2,3,4,7  OUTPUTS 

LD  A,11001111B  ;MAKE  PORT  A  CONTROL 

OUT  (PIOCRA),A 

LD  A,01100010B  ;LINES  1,5,6.  INPUTS— 0,2,3,4,7  OUTPUTS 

OUT  (PIOCRA).A 


;MAKE  PORT  A  CONTROL 
;ALL  BITS  INPUTS 

;MAKE  PORT  B  CONTROL 
;ALL  BITS  OUTPUTS 
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Z80  INPUT/OUTPUT  INSTRUCTIONS 


Z80  I/O 

INSTRUCTIONS 


The  Z80  microprocessor  has  an  extensive  set  of  Input/Output 
instructions.  All  I/O  instructions  use  8-bit  device  addresses, 
thus  allowing  up  to  256  input  ports  and  256  output  ports.  But 
remember  that  each  PIO  occupies  four  output  port  addresses  and  four  input  port  ad- 
dresses. 

The  I/O  instructions  can  be  grouped  as  follows: 

II  Instructions  that  use  absolute  addressing.  IN  A, (port)  and  OUT  (portlA  transfer 
eight  bits  of  data  between  the  Accumulator  and  the  port  addressed  by  the  second 
byte  of  the  instruction. 

2)  Single-byte  instructions  that  use  register  indirect  addressing.  IN  reg,(C)  and  OUT 
(O.reg  transfer  eight  bits  of  data  between  the  specified  register  and  the  port  ad- 
dressed by  Register  C. 

3)  Block  I/O  instructions.  INI  and  OUTI  transfer  eight  bits  of  data  between  the  memory 
location  addressed  by  Register  Pair  HL  and  the  port  addressed  by  Register  C.  Both 
instructions  then  increment  Register  Pair  HL  and  decrement  the  byte  counter  in 
Register  B.  The  Z  flag  is  set  if  B  is  decremented  to  zero  and  reset  otherwise.  IND  and 
OUTD  are  the  same  instructions  except  that  they  decrement  Register  Pair  HL  in- 
stead of  incrementing  it. 

4)  Repeated. Block  I/O  instructions.  INIR  and  OTIR  repeat  the  effects  of  INI  and  OUTI, 
respectively,  until  B  is  decremented  to  zero.  INDR  and  OTDR  have  the  same  rela- 
tionship to  IND  and  OUTD. 

You  should  note  the  following  features  of  each  group  of  instructions: 

1)  Instructions  with  absolute  addressing. 

•  Data  is  always  transferred  to  or  from  the  Accumulator. 

•  No  flags  are  affected. 

•  The  port  address  is  part  of  the  program  memory  and 
cannot  be  changed  if  that  memory  is  read-only. 

2)  Single-byte  instructions  with  register  indirect  addressing. 

•  Data  can  be  transferred  to  or  from  any  of  the  primary  8- 
bit  registers  (A,B,C,D,E,H,L).  However,  remember  that 
Register  C  contains  the  port  address. 

•  IN  reg,(C!  sets  the  Sign  !S),  Zero  (Z),  and  Parity  (P/0) 

flags  according  to  the  value  of  the  input  data.  The  Carry  flag  (C)  is  not  modified, 
but  the  Half  Carry  (H)  and  Negative  (N)  flags  are  reset.  OUT  (O.reg  does  not 
affect  any  flags. 

•  The  port  address  is  always  in  Register  C.  This  address  is  not        | I/O  DRIVER  | 

part  of  the  program  memory  and  could  be  a  parameter  for 

an  I/O  subroutine  (or  I/O  driver!.  One  i/0  driver  could  thus  be  used  in  several 

different  applications  or  with  several  similar  I/O  devices  in  the  same  application. 


I/O 

INSTRUCTIONS 
WITH  ABSOLUTE 
ADDRESSINQ 


I/O 

INSTRUCTIONS 
WITH  INDIRECT 
ADDRESSING 
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BLOCK  I/O 
INSTRUCTIONS 


I/O 

INSTRUCTION 
EXAMPLES 


3)    Block  I/O  instructions. 

•  Data  is  always  transferred  to  or  from  the  mennorv  location 
addressed  by  Register  Pair  HL. 

•  The  Z  (Zero)  flag  is  set  if  Register  B  is  decremented  to  zero  and  cleared  other- 
wise. The  S  (Sign),  P/0  (Parity),  and  H  (Half  Carry)  flags  are  affected,  but  their 
final  yalues  are  uncertain. 

■  The  port  address  is  always  in  Register  C.  Here  again,  this  address  could  be  a 
paranneter  for  an  I/O  driver. 

•  Register  B  is  an  8-bit  counter.  Thus,  the  repeated  Block  I/O  instructions  can 
transfer  a  maximum  of  256  bytes.  This  differs  from  the  Block  Move  and  Block 
Compare  instructions,  which  use  Register  Pair  BC  as  a  16-bit  counter  and  can 
handle  up  to  65K  bytes. 

Some  examples  of  the  various  I/O  instructions  (without  any 
timing  considerations)  are: 

1)  Load  the  Accumulator  from  Input  Port  2. 

a.  Using  absolute  addressing 

IN  A,  (2) 

b.  Using  register  indirect  addressing 

LD  0,2 
IN  A,(C) 

2)  Store  the  contents  of  the  Accumulator  in  Output  Port  5. 

a.  Using  absolute  addressing 

OUT  (5),A 

b.  Using  register  indirect  addressing 

LD  C,5 
OUT  (C),A 

3)  Load  memory  location  0040  from  Input  Port  2. 

a.  Using  absolute  addressing 

IN  A.(2)  :GETDATA 

LD  (40H).A    ;  STORE  DATA 

b.  Using  register  indirect  addressing 

LD  C,2         :GET  PORT  NUMBER 

IN  A,(C)       :GET  DATA 

LD  (40H),A    -.STORE  DATA 

c.  Using  block  I/O 

LD  C.2         -.GET  PORT  NUMBER 

LD  HL,40H     ;GET  MEMORY  DESTINATION 

INI  :GET  DATA 
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4)    Store  the  contents  of  memory  location  0040  in  Output  f  ort  5. 
a.  Using  absolute  addressing 


LD 
OUT 


A,(40H) 
(5),A 


:GET  DATA 
:SEND  DATA 


Using  register  indirect  addressing 

LD  C,5         ;GET  PORT  NUMBER 

LD  A,(40H)    :GET  DATA 

OUT  (C),A 


0.  Using  block  I/O 

LD 
LD 
OUT! 


C.5         :GET  PORT  NUMBER 
HL.40H     ;GET  MEMORY  SOURCE 
;SEND  DATA 


5)    Load  memory  locations  0040  through  0047  from  Input  Port  2. 


a.  Using  absolute  addressing 


LD 
LD 

INBYTE:  IN 
LD 
INC 


HL.40H 
B,8 
A,  (2) 
(HU.A 
HL 


GET  STARTING  ADDRESS  OF  DATA 
BYTE  COUNTER  =  8 
FETCH  DATA  BYTE 
STORE  BYTE  IN  MEMORY 


DJNZ  INBYTE 

b.  Using  block  I/O 

LD 
LD 
LD 

INBYTE:  INI 
JR 

c.  Using  repeated  block  I/O 

LD  HL.40H 

LD  B,8 

LD  C,2 
INIR 


HL,40H 

B,  8 

C.  2 

NZ.INBYTE 


GET  STARTING  ADDRESS  OF  DATA 
BYTE  COUNTER  =  8 
GET  PORT  NUMBER 


GET  STARTING  ADDRESS  OF  DATA 

BYTE  COUNTER  =  8 

GET  PORT  NUMBER 

MOVE  INPUT  BYTES  TO  MEMORY 
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6)    Send  the  contents  of  memory  locations  0040  through  0047  to  Output  Port  5. 
a.  Using  absolute  addressing 


LD 

HL,40H 

GET  STARTING  ADDRESS  OF  DATA 

LD 

B,8 

GET  BYTE  COUNTER 

0TB  YTE: 

LD 

A.lHL) 

ccTfu  BYTF  FROM  MEMORY 

1  L.i'^lt             ll_  i  llWIVi    tV)l— IVIWIil 

OUT 

(5).A 

OUTPUT  BYTE 

INC 

HL 

DJNZ 

OTBYTE 

b.  Using 

block  I/O 

LD 

HL,40H 

GFT  STARTING  AnnRFS"?  OF  DATA 

LD 

B.8 

npj  BYTE  rniiNTFR 

LD 

C,5 

OCT  PORT  NUMBFR 

OTBYTE; 

OUTI 

OUTPUT  BYTE  FROM  MEMORY 

JR 

NZ.OTBYTE 

c.  Using 

repeated  block  I/O 

LD 

HL.40H 

GET  STARTING  ADDRESS  OF  DATA 

LD 

B.8 

GET  BYTE  COUNTER 

LD 

C,5 

GET  PORT  NUMBER 

OTIR 

OUTPUT  BYTES  FROM  MEMORY 

Note  that  the  repeated  Block  I/O  instructions  operate  con-        USING  BLOCK 
tmuously.  You  cannot  provide  any  timing  between        I/O  INSTRUCTIONS 

transfers.  Thus,  these  instructions  cannot  be  used  unless 

the  peripheral  operates  at  the  same  speed  as  the  processor  or  timing  is  handled  sepa- 
rately in  hardware.  Ways  to  handle  timing  in  hardware  include  forcing  the  processor 
into  Wait  states  or  buffering  the  data.  Note  that  the  Block  I/O  instructions  all  p(ace  the 
contents  of  the  byte  counter  (Register  B)  on  the  top  half  of  the  .Address  Bus  during  the 
actual  I/O  transfer.  In  output  operations.  Register  B  is  decremented  first.  The  byte 
counter  value  is  then  available  to  external  circuitry. 

An  obvious  application  for  Block  I/O  instructions  is  the  configuration  of  PIOs.  Several 
words  must  often  be  sent  to  a  control  register  to  determine  operating  mode,  select  pin 
directions,  and  establish  the  interrupt  system.  No  timing  problems  occur,  since  PIOs 
operate  at  the  same  speed  as  the  CPU.  We  will  discuss  the  configuration  of  Z80  PIOs 
and  serial  interfaces  jSIOsj  with  Block  I/O  instructions  later  in  this  chapter  and  in 
Chapter  12. 

In  subsequent  I/O  examples,  we  will  use  mainly  the  instructions  with  absolute  address- 
ing. You  can  easily  substitute  the  instructions  with  register  indirect  addressing  as  long 
as  you  remember  to  initialize  Register  C.  We  will  occasionally  indicate  applications  for 
the  Block  I/O  instructions. 
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+  5V 

Q 


Pustibutton 


Figure  11-10.  A  Pushbutton  Circuit 

EXAMPLES 

A  Pushbutton  Switch 

Purpose:  To  interface  a  single  pushbutton  switch  (or  a  single-pole,  single-throw  (SPST) 
switch!  to  a  Z80  microprocessor.  The  pushbutton  is  a  mechanical  switch  that 
provides  a  single  contact  closure  (i,e,,  a  logic  zero)  while  pressed. 

Circuit  Diagram: 

Figure  11-10  shows  the  circuitry  required  to  interface  the  pushbutton.  It  uses  one  bit  of 
a  Z80  PIO  that  acts  as  a  buffer;  no  latch  is  needed,  since  the  pushbutton  remains 
closed  for  many  CPU  clock  cycles.  Pressing  the  button  grounds  the  PIO  input  bit.  The 
pullup  resistor  ensures  that  the  input  bit  is  one  if  the  button  is  not  being  pressed. 

Programming  Examples: 

We  will  perform  two  tasks  with  this  circuit.  They  are: 
a)    Set  a  memory  location  based  on  the  state  of  the  button, 
bl    Count  the  number  of  times  that  the  button  is  pressed. 
Task  1:  Determine  switch  closure. 

Purpose:  Set  memory  location  0040  to  one  if  the  button  is  not  being  pressed,  and  to 
zero  if  It  is  being  pressed. 

Sample  Cases: 

1)  Button  open  (i.e,,  not  pressed) 
Result  =  (0040)  =01 

2)  Button  closed  (i.e.,  pressed) 
Result  =  (0040)  =00 
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Flowchart: 


(0040)  =  0 


input  and  [Ttask 
pushbutton 
data 


(0040)  =  1 


Q  End  ^ 

Source  Program: 


DONE; 


LD 

A,01001111B 

:MAKE  PORT  A  INPUT 

OUT 

(PIOCRAl.A 

LD 

HL,40H 

:MARKER  =0 

LD 

(HL),0 

IN 

A,(PIODRA) 

:READ  BUTTON  POSITION 

AND 

MASK 

;IS  BUTTON  CLOSED  (0)? 

JR 

Z.DONE 

;YES,  DONE 

INC 

(HU 

:N0,  MARKER  =  1 

HALT 
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Object  Program: 


Memory  Location 

Msmorv  Contsnts 

inotn  (r*tir\n 
M  loLl  uUllUi  i 

(Hex) 

\nex/ 

(Mnemonic) 

0000 

3E 

LD 

A.OIOOmiB 

0001 

4F 

0002 

D3 

OUT 

(PIOCRA).A 

0003 

PIOCRA 

0004 

2-1 

LD 

HL.40H 

0005 

40 

0006 

00 

0007 

36 

LD 

(HU.O 

0008 

00 

0009 

DB 

IN 

A,  (PIODRA) 

OOOA 

PIODRA 

OOOB 

E6 

AND 

MASK 

OOOC 

MASK 

OOOD 

28 

JR 

Z,DONE 

OOOE 

01 

OOOF 

34 

INC 

(HL) 

0010 

76 

HALT 

The  port  addresses  PIOCRA  and  PIODRA  depend  on  how  the  PIO  is  connected  in  your 
microcomputer.  The  PIO  control  lines  are  not  used  in  this  example.  In  fact,  we  could 
place  the  A  side  of  the  PIO  in  the  control  mode  with  the  starting  sequence: 

LD  A,11001111B     :  MAKE  PORT  A  CONTROL 

OUT  (PIOCRA),A 

LD  A.OFFH  ;ALL  BITS  INPUTS 

OUT  (PIOCRAj.A 

MASK  depends  on  the  bit  to  which  the  pushbutton  is  connected;  it  has  a  one  in  the 
button  position  and  zeros  elsewhere. 


Button  Position 
(Bit  Number) 

Mask 

Binary 

Hex 

0 

00000001 

01 

1 

00000010 

02 

2 

00000100 

04 

3 

00001000 

08 

4 

00010000 

10 

5 

00100000 

20 

6 

01000000 

40 

7 

10000000 

80 

If  the  button  is  attached  to  bit  0  or  bit  7  of  the  input  port,  the  program  can  use  a  Shift 
instruction  to  set  the  Carry  and  thereby  determine  the  button's  state.  For  example. 

Bit  7 

A,  (PIODRA)    ;READ  BUTTON  POSITION 

:IS  BUTTON  CLOSED  KERO)? 
NCDONE      ;YES,  DONE 


A,  (PIODRA)    :READ  BUTTON  POSITION 

:IS  BUTTON  CLOSED  (ZERO)? 
NCDONE      :YES.  DONE 
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The  procedure  for  bit  7  is  even  simpler  if  we  have  the  address  of  the  PIO  data  register  in 
Register  C.  This  is  because  the  input  instructions  using  register  indirect  addressing 
ie.g.,  IN  A, (OS  affect  the  Sign  flag.  The  required  sequence  is: 

Bit  7  (PIODRA  in  Register  C) 

IN  A,(C)  ;READ  BUTTON  POSITION 

JP  P.DONE        '.DONE  IF  BUTTON  CLOSED  iZEROI 

If  the  button  is  attached  to  bits  6  or  7  of  the  input  port,  the  program  can  use  the  Sign  bit 
to  determine  the  button's  state.  For  example. 

Bit  7 

IN  A.fPIODRA)  :READ  BUTTON  POSITION 

AND  A  :IS  BUTTON  CLOSED  (ZERO)? 

JP  P.DONE  ;YES.  DONE 

IN  A,(port)  does  not  affect  the  flags;  therefore,  we  must  use  the  AND  A  instruction  to 
set  the  flags  without  changing  the  Accumulator. 

Bite 


IN  A,(PIODRA) 
ADD  A.A 
JP  P.DONE 


READ  BUTTON  POSITION 
IS  BUTTON  CLOSED  (ZERO)? 
YES,  DONE 


RLA  cannot  be  used  because  it  does  not  affect  the  Sign  bit. 
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Task  2;  Count  switch  closures. 

Purpose:  Count  the  number  of  button  closures  by  incrementing  memory  location  0040 
after  each  closure. 

Sample  Case: 

Pressing  the  button  ten  times  after  the  start  of  the  program  should  give 
(0040)  =  OA 

Note;  In  order  to  count  the  number  of  times  that  the  button  has 
been  pressed,  we  must  be  sure  that  each  closure  causes  a  single 
transition.  However,  a  mechanical  pushbutton  does  not  produce  a 
single  transition  for  each  closure,  because  the  mechanical  contacts  bounce  back  and 
forth  before  settling  into  their  final  positions.  We  can  use  a  one-shot  to  eliminate  the 
bounce  or  we  can  handle  it  in  software. 

The  program  can  debounce  the  pushbutton  by  waiting  after  it 
finds  a  closure.  The  required  delay  is  called  the  debouncing 
time  and  is  part  of  the  specifications  of  the  pushbutton.  It  is 
typically  a  few  milliseconds  long.  The  program  should  not  examine  the  pushbutton  dur- 
ing this  period,  because  it  might  mistake  the  bounces  for  new  closures.  The  program 
may  either  enter  a  delay  routine  like  the  one  described  previously  or  may  simply  per- 
form other  tasks  for  the  specified  amount  of  time. 

Even  after  debouncing,  the  program  must  still  wait  for  the  present  closure  to  end  before 
looking  for  a  new  closure.  This  procedure  avoids  double  counting.  The  following  pro- 
gram uses  a  software  delay  of  1  ms  to  debounce  the  pushbutton.  You  may  want  to  try 
varying  the  delay  or  eliminating  it  entirely  to  see  what  happens.  To  run  this  program, 
you  must  also  enter  the  delay  subroutine  into  memory  starting  at  location  0030. 

Flowchart: 


button  still  being 
pressed 

Tno 


SWITCH 
BOUNCE 


DEBOUNCING 
IN  SOFTWARE 
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Source  Program: 

LD  A.OIOOIIIIB  :MAKE  PORT  A  INPUT 

OUT  !PIOCRA),A 

LD  HL,40H 

LD  (HU,0  :CLOSURE  COUNT  =  ZERO 

CHKCL;    IN  A,(PIODRA)  :READ  BUTTON  POSITION 

AND  MASK  ;IS  BUTTON  BEING  PRESSED  (0)? 

JR  NZ.CHKCL  :N0,  WAIT  UNTIL  IT  IS 

INC  (HU  :YES,  INCREMENT  CLOSURE  COUNT 

CALL  DELAY  ;WAIT  1  MS  TO  DEBOUNCE 

CHKOP;    IN  A,(PIODRA)  -.READ  BUTTON  POSITION 

AND  MASK  :IS  BUTTON  STILL  BEING  PRESSED  (0)? 

JR  Z.CHKOP  :YES,  WAIT  FOR  RELEASE 

JR  CHKCL  :N0,  LOOK  FOR  NEXT  CLOSURE 

Object  Program: 


Memory  Location     Memory  Contents  instruction 
(Hex)  (Hex)  (Mnemonlcl 


0000  3E  LD  A.OIOOIIIIB 

0001  4F 

0002  D3  OUT  (PIOCRAl.A 

0003  PIOCRA 

0004  21  LD  HL.40H 

0005  40 

0006  00 

0007  36  LD  (HU.O 

0008  00 

0009  DB  CHKCL:    IN  A.(PIODRA) 
OOOA  PIODRA 

OOOB  E6  AND  MASK 

OOOC  MASK 

OOOD  20  JR  NZ.CHKCL 

OOOE  FA 

OOOF  34  INC  (HU 

0010  CD  CALL  DELAY 

001 1  30 

0012  00 

0013  DB  CHKOP:    IN  A.  (PIODRA) 

0014  PIODRA 

0015  E6  AND  MASK 

0016  MASK 

0017  28  JR  Z.CHKOP 

0018  FA 

0019  18  JR  CHKCL 
001 A  EE 


The  three  instructions  beginning  with  the  label  CHKOP  are  used  to  determine  when  the 
switch  reopens. 

Clearly  we  do  not  really  need  a  PIO  for  this  simple  interface.  An  addressable  tri-state 
buffer  would  do  the  job  at  far  lower  cost. 
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A  Toggle  Switch 

Purpose:  To  Interface  a  single-poie,  double-throw  (SPOT)  toggle  switch  to  a  Z80 
microprocessor.  The  toggle  is  a  mechanical  device  that  is  either  in  the  nor- 
mally closed  (NO  position  or  the  normally  open  (NO)  position. 

Circuit  Diagram: 

Figure  11-11  shows  the  circuitry  required  to  interface  the 
switch.  Like  the  pushbutton,  the  switch  uses  one  bit  of  a  Z80 
PIO  that  serves  as  an  addressable  buffer.  Unlike  the  button,  the 
switch  may  be  left  in  either  position.  Typical  program  tasks  are 
to  determine  the  switch  position  and  to  see  if  the  position  has 
changed.  Either  a  one-shot  with  a  pulse  length  of  a  few  milliseconds  or  a  pair  of  cross- 
coupled  NAND  gates  (see  Figure  11-12)  can  debounce  a  mechanical  switch. 

The  circuits  will  produce  a  single  step  or  pulse  in  response  to  a  change  in  switch  posi- 
tion even  if  the  switch  bounces  before  settling  into  its  new  position. 

Programming  Examples: 

We  will  perform  two  tasks  involving  this  circuit.  They  are: 

1)  Set  a  memory  location  to  one  when  the  switch  is  closed. 

2)  Set  a  memory  location  to  one  when  the  state  of  the  switch  changes. 
Task  1 :  Wait  for  switch  to  close. 

Purpose:  Memory  location  0040  Is  zero  until  the  switch  is  closed  and  then  is  set  to 
one:  that  is,  the  processor  clears  memory  location  0040.  waits  for  the  switch 
to  be  closed,  and  then  sets  memory  location  0040  to  one. 

The  switch  could  be  marked  Run/Halt,  since  the  processor  will  not  proceed  until  the 
switch  is  closed. 

Flowchart: 


DEBOUNCING 
WITH 

CROSS-COUPLED 
NAND  QATES 
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NC 

Switch^  , 

Debounce 
Circuit 

PIO 

To  CPU 

NO 

Figure  11-11.  A  Toggle  Switch  Circuit 


+  5V 


To  I/O  Port  (PIO) 


Figure  11-12.  A  Debounce  Circuit  Based  on  Cross-coupled  NAND  Gates 
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Source  Program: 


LD 

A,01001111B 

;MAKE  PORT  A  INPUT 

OUT 

(PIOCRAi.A 

LD 

HL,40H 

LD 

(HU.O 

;MARKER  =ZERO 

IN 

A.IPIOORA) 

:  READ  SWITCH  POSITION 

AND 

MASK 

:IS  SWITCH  CLOSED  (ZERO)? 

JR 

NZ.WAITC 

■.NO,  WAIT  FOR  SWITCH  TO  CLOSE 

INC 

(HL) 

:YES,  MARKER  =  1 

HALT 

Object  Program: 


Memorv  Location 

Memorv  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

3E 

LD 

A,01001111B 

0001 

4F 

0002 

D3 

OUT 

(PIOCRA),A 

0003 

PIOCRA 

0004 

21 

LD 

HL,40H 

0005 

40 

0006 

00 

0007 

36 

LD 

(HU.O 

0008 

00 

0009 

DB 

WAITC:  IN 

A,  (PIODRA) 

OOOA 

PIODRA 

OOOB 

E6 

AND 

MASK 

OOOC 

MASK 

OOOD 

20 

JR 

NZ.WAITC 

OOOE 

FA 

OOOF 

34 

INC 

(HL) 

0010 

76 

HALT 
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Task  2:  Wait  for  switch  to  change. 

Purpose:  Memory  location  0040  remains  zero  until  the  switch  position  changes:  i.e., 
the  processor  waits  until  the  switch  changes,  then  sets  memory  location 
0040  to  1. 

Flowchart: 


c 


Stan 


(40)  =  0 


Old  data  = 
switch  position 


Source  Program: 


SRCH: 


c 


LD 

A.OIOOnilB 

:MAKE  PORT  A  INPUT 

OUT 

(PIOCRAI.A 

LD 

HL.40H 

LD 

IHU.O 

iMARKER  =  ZERO 

IN 

A.(PIODRA) 

;GET  OLD  SWITCH  POSITION 

AND 

MASK 

LD 

B.A 

IN 

A,(PIODRA) 

:GET  NEW  SWITCH  POSITION 

AND 

MASK 

CP 

B 

;ARE  NEW  AND  OLD  POSITIONS  THE  SAME? 

JR 

Z,SRCH 

:YES.  WAIT 

INC 

(HU 

:N0,  MARKER  =  ONE 

HALT 
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Object  Program: 


Memory  Location 

Memorv  Contents 

instruction 

(Hex) 

(Hex) 

(Mnemonic) 

uuuu 

oL 

LD 

A,01001111B 

UUU  1 

A  C 

uo 

OUT 

(PIOCRA),A 

uuuo 

21 

LD 

HL,40H 

0005 

40 

0006 

00 

0007 

DB 

IN 

A,  (PIODRA) 

nonR 

PinnRA 

0009 

E6 

AND 

MASK 

OOOA 

MASK 

OOOB 

47 

LD 

B,A 

OOOC 

IN 

A.  (PIODRA) 

OOOD 

PIODRA 

OOOE 

E6 

AND 

MASK 

OOOF 

MASK 

0010 

88 

CP 

B 

0011 

28 

JR 

Z.SRCH 

0012 

F9 

0013 

34 

INC 

(HL) 

0014 

76 

HALT 

A  Subtract  or  Exclusive  OR  could  replace  the  Compare  in  the  program.  Either  of  these 
instructions  would,  however,  change  the  contents  of  the  Accumulator.  The  Exclusive 
OR  would  be  useful  if  several  switches  were  attached  to  the  same  PIO,  since  it  would 
produce  a  one  bit  for  each  switch  that  changed  state.  How  would  you  rewrite  this  pro- 
gram so  as  to  debounce  the  switch  in  software? 
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Figure  11-13.  A  Multiple-Position  Switch 

A  Multiple-Position  (Rotary,  Selector,  or  Thumbwheel)  Switch 

Purpose:  To  interface  a  multiple-position  switch  tea  microprocessor.  The  lead  corres- 
ponding to  the  switch  position  is  grounded,  while  the  other  leads  are  high 
(logic  ones). 

Circuit  Diagram: 

Figure  1 1-13  shows  the  circuitry  required  to  interface  an  8-position  switch.  The  switch 
uses  all  eight  data  bits  of  one  side  of  a  PIO.  Typical  tasks  are  to  determine  the  position 
of  the  switch  and  to  check  whether  or  not  that  position  has  changed.  Two  special  situa- 
tions must  be  handled; 

1)  The  switch  is  temporarily  between  positions  so  that  no  leads  are  grounded. 

2)  The  switch  has  not  vet  reached  its  final  position. 

The  first  of  these  situations  can  be  handled  by  waiting  until  the  input  is  not  all  ones,  i.e.. 
until  a  switch  lead  is  grounded.  We  can  handle  the  second  situation  by  examining  the 
switch  again  after  a  delay  (such  as  1  or  2  seconds)  and  only  accepting  the  input  when 
It  remains  the  same.  This  delay  will  not  affect  the  responsiveness  of  the  system  to  the 
switch.  We  can  also  use  another  switch  (i.e.,  a  Load  switch)  to  tell  the  processor  when 
the  selector  switch  should  be  read. 

Programming  Examples: 

We  will  perform  two  tasks  involving  the  circuit  of  Figure  11-13.  These  are: 

a)  Monitor  the  switch  until  it  is  in  a  definite  position,  then  determine  the  position  and 
store  its  binary  value  in  a  memory  location. 

b)  Wait  for  the  position  of  the  switch  to  change,  then  store  the  new  position  in  a 
memory  location. 

If  the  switch  IS  in  a  position,  the  lead  from  that  position  is  grounded  through  the  com- 
mon line.  Pullup  resistors  on  the  input  lines  avoid  problems  caused  by  noise. 
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Table  1 1-3.  Data  Input  vs.  Switch  Position 


Switch  Position 

Data  Input 

R !  n  3  rv 

1 1  lot  y 

Hex 

0 

11111110 

FE 

1 

11111101 

FD 

2 

11111011 

FB 

3 

11110111 

F7 

4 

11101111 

EF 

5 

11011111 

DF 

6 

10111111 

BF 

7 

01111111 

7F 

Task  1:  Determine  switch  position. 

Purpose:  The  program  waits  for  the  switch  to  be  in  a  specific  position  and  then  places 
the  number  of  that  position  into  memory  location  0040. 

Table  1 1-3  contains  the  data  inputs  corresponding  to  the  various  switch  positions. 

This  scheme  is  inefficient,  since  it  requires  eight  bits  to  distinguish  among  eight 
different  positions. 

A  TTL  or  MOS  encoder  could  reduce  the  number  of  bits  needed. 
Figure  11-14  shows  a  circuit  using  the  74LS148  TTL  8-to-3  en- 
ooder.4  We  attach  the  switch  outputs  in  inverse  order,  since  the 
74LS148  device  has  active-low  inputs  and  outputs.  The  output  of 
the  encoder  circuit  is  a  3-bit  representation  of  the  switch  position.  Many  switches  in- 
clude encoders  so  that  their  outputs  are  coded,  usually  as  a  BCD  digit  (in  negative 
logic). 

The  encoder  produces  active-low  outputs,  so,  for  example,  switch  position  5,  which  is 
attached  to  input  2.  produces  an  output  of  2  in  negative  logic  (or  5  in  positive  logic). 
You  mav  want  to  verify  the  double  negative  for  yourself. 


USING 
A  TTL 
ENCODER 


o 


Common 


— gSB 


741S148 
8-to-3 
Encoder 


Figure  11-14.  A  Multiple-Position  Switch  with  an  Encoder 
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Flowchart; 


 ^1 

Shift  data 
nght  1  bit 

Cany  0 
JLNo 

Position  = 
Position  +  1 

(0040)  =  Position 


c 


3 


Source  Program: 


LD 

A,01001111B 

MAKE  PORT  A  INPUT 

OUT 

(PIOCRA),A 

CHKSW: 

IN 

A.(PIODRA) 

GET  SWITCH  DATA 

CP 

OFFH 

IS  SWITCH  IN  A  POSITION? 

JR 

Z.CHKSW 

NO,  WAIT  FOR  A  POSITION 

LD 

B.O 

SWITCH  POSITION  =  ZERO 

CHPOS: 

RRA 

IS  NEXT  BIT  GROUNDED  POSITION? 

JR 

NC.DONE 

YES,  SWITCH  POSITION  FOUND 

INC 

B 

NO,  INCREMENT  SWITCH  POSITION 

JR 

CHPOS 

DONE. 

LD 

HL,40H 

STORE  SWITCH  POSITION 

LD 

(HD.B 

HALT 
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Object  Program: 


ivicillUtV  t-UOaiiUM 

1  vici  1      y  v  ui  1  isst  1 1,3 

Instruction 

fMovi 

(Mnemonic) 

0000 

3E 

LD 

A.01001111B 

0001 

4F 

0002 

D3 

OUT 

|PI0CRA),A 

0003 

PIOCRA 

0004 

DB 

CHKSW: 

IN 

A,  (PIODRA) 

0005 

PIODRA 

0006 

FE 

CP 

OFFH 

0007 

FF 

0008 

28 

JR 

Z.CHKSW 

0009 

FA 

OOOA 

06 

LD 

B.O 

OOOB 

00 

OOOC 

IF 

CHPOS; 

BRA 

OOOD 

30 

JR 

NCDONE 

OOOE 

03 

UOUr 

U4 

INC 

B 

0010 

18 

JR 

CHPOS 

0011 

FA 

0012 

21 

DONE: 

LD 

HL40H 

0013 

40 

0014 

00 

0015 

70 

LD 

(HL),B 

0016 

76 

HALT 

Suppose  that  a  faulty  switch  or  defective  PIO  results  in  the  input  always  being  OFF-jg. 
How  could  you  change  the  program  so  that  it  would  detect  this  error? 


There  Is  an  unconditional  jump,  JR  CHPOS,  in  the  source  program.  Can  you  change  the 
initial  conditions  so  as  to  make  this  instruction  unnecessary? 

This  example  assumes  that  the  switch  is  debounced  in  hardware.  How  would  you 
change  the  program  to  debounce  the  switch  in  software? 
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Task  2:  Wait  for  switch  position  to  change. 

Purpose:  The  program  waits  for  the  switch  position  to  change  and  places  the  new 
position  (decoded)  into  memory  location  0040.  The  program  waits  until  the 
switch  reaches  its  new  position. 

Flowchart: 


c 


Old  data  = 

Switch  position 


New  data  = 

Switch  position 


Shift  data  right  1  bit 


C 


End 
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Source  Program: 

LD  A,01001111B  ;MAKE  PORT  A  INPUT 

OUT  (PIOCRAf.A 

CHFST;    IN  A.lPIODRA)  :GET  SWITCH  DATA 

CP  OFFH  ;IS  SWITCH  IN  A  POSITION? 

JR  Z,CHFST  ;N0.  WAIT  UNTIL  IT  IS 

LD  B.A 

CHSEC;    IN  A.fPIODRA)  :,GET  NEW  SWITCH  DATA 

CP  OFFH  ;IS  SWITCH  IN  A  POSITION? 

JR  Z.CHSEC  :N0,  WAIT  UNTIL  IT  IS 

CP  B  ;IS  POSITION  SAME  AS  BEFORE? 

JR  Z.CHSEC  :YES,  WAIT  FOR  IT  TO  CHANGE 

LD  B.OFFH  ;SWITCH  POSITION  =-1 

CHPOS.    INC  B  ;INCREMENT  SWITCH  POSITION 

RRA  ;IS  NEXT  BIT  GROUNDED  POSITION? 

JR  C.CHPOS  :N0.  KEEP  LOOKING  FOR  GROUNDED  POSITION 

LD  HL,40H  ;STORE  SWITCH  POSITION 

LD  (HU.B 

HALT 
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Object  Program: 


Mpmnrv  i  nratinn 

(Hex) 

Mpmnrv  Cnntpnt^ 

(Hex) 

Instruction 
(Mnemonic) 

0000 

3E 

LD 

A.oioomiB 

0001 

4F 

0002 

D3 

OUT 

{PIOCRA),A 

0003 

PIOCRA 

0004 

DB 

CHFST; 

IN 

A,  (PIODRA) 

0005 

PIODRA 

0006 

FE 

CP 

OFFH 

0007 

FF 

0008 

28 

JR 

Z,CHFST 

0009 

FA 

OOOA 

47 

LD 

B.A 

O'OOB 

DB 

CHSEC: 

IN 

A,  (PIODRA) 

OOOC 

PIODRA 

OOOD 

FE 

CP 

OFFH 

OOOE 

FF 

OOOF 

28 

JR 

Z.CHSEC 

0010 

FA 

0011 

B8 

CP 

B 

0012 

28 

JR 

Z.CHSEC 

0013 

F7 

0014 

06 

LD 

B.OFFH 

0015 

FF 

0016 

04 

CHPOS; 

INC 

B 

■j  p 

RRA 

0018 

38 

JR 

CCHPOS 

0019 

FC 

001 A 

21 

LD 

HL,40H 

001 B 

40 

001 C 

00 

001 D 

70 

LD 

(HL),B 

001 E 

76 

HALT 

An  alternative  method  for  determining  if  the  switch  is  in  a  position  Is: 

CHKSW:  IN  A.(PIODRA) 
INC  A 
JR  Z.CHKSW 


Why  does  this  work?  What  happens  to  the  input  data? 
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A  Single  LED 

Purpose:  To  interface  a  single  light-emitting  diode  to  a  Z80  microprocessor.  The  LED 
can  be  attached  so  that  either  a  logic  zero  or  a  logic  one  turns  it  on. 

Circuit  Diagram: 


Figure  11-15  shows  the  circultrv  required  to  interface  an  LED.  The  LED 
LED  lights  when  its  anode  is  positive  with  respect  to  its  cathode  CONTROL 
(Figure  1 1-1 5a).  Therefore,  vou  can  either  light  the  LED  bv  ground- 
ing the  cathode  and  having  the  computer  supply  a  one  to  the  anode  (Figure  1 1  -1 5b)  or 
by  connecting  the  anode  to  +5  volts  and  having  the  computer  supply  a  zero  to  the 
cathode  (Figure  1 1-1 5c).  Using  the  cathode  is  the  most  common  approach.  The  LED  is 
brightest  when  it  operates  from  pulsed  currents  of  about  10  or  50  mA  applied  a  few 
hundred  times  per  second.  LEDs  have  a  very  short  turn-on  time  (in  the  microsecond 
range)  so  they  are  well  suited  to  multiplexing  (operating  several  from  a  single  port).  LED 
circuits  usually  need  peripheral  or  transistor  drivers  and  current-limiting  resistors.  MOS 
devices  normally  cannot  drive  LEDs  directly  and  make  them  bright  enough  for  easy 
viewing. 

Note:  The  PIO  has  an  output  latch  on  each  port.  However,  the  B  port  is  normally  used 
for  output,  since  it  has  somewhat  more  drive  capability.  In  particular,  the  B  port  outputs 
are  capable  of  driving  Darlington  transistors  (providing  1.5  mA  minimum  at  1.6  V). 
Darlington  transistors  are  high-gain  transistors  capable  of  switching  large  amounts  of 
current  at  high  speed:  they  are  useful  in  driving  solenoids,  relays,  and  other  devices. 

Tasl<:  Turn  the  light  on  or  off. 

Purpose:  The  program  turns  a  single  LED  either  on  or  off. 

A.  Send  a  Logic  One  to  the  LED  (turn  a  positive  display  on  or  a  negative  display  off). 
Source  Program: 

(form  data  initially) 
LD 
OUT 
LD 
OUT 
HALT 

An  alternative  using  the  control  mode  Is: 


A.00001111B 
(PIOCRB>,A 
A,MASKP 
(PIODRB),A 


:MAKE  PORT  B  OUTPUT 

:GET  DATA  FOR  LED 
:SEND  DATA  TO  LED 


A.1 1001 11  IB     : MAKE  PORT  B  CONTROL 
(PIOCRB),A 
A 

(PIOCRB),A 
A.MASKP 
(PIODRB),A 


:MAKE  ALL  B  LINES  OUTPUTS 

:GET  DATA  FOR  LED 
:SEND  DATA  TO  LED 


LD 
OUT 
SUB 
OUT 
LD 
OUT 
HALT 

(update  data) 
IN 
SET 
OUT 
HALT 

MASKP  has  a  one  bit  in  the  LED  position  and  zeros  elsewhere.  Note  that  we  can  read 
the  PIO  Data  Output  register  when  the  PIO  is  in  the  output  mode.  We  can  also  read  any 
combination  of  input  data  and  output  register  data  when  the  PIO  is  in  the  control 
mode;  the  combination  is  defined  by  the  assignment  of  inputs  and  outputs. 


A,(PIODRB) 

LED.A 

(PIODRB),A 


GET  OLD  DATA 
TURN  ON  LED  BIT 
SEND  DATA  TO  LED 
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R  Anode  Cathode 

,-5VO  ^  


a)    Basic  LED  circuitrv.  The  resistor  R  should  limit  the  maximum  current  to  50  mA  and 
the  average  current  to  10  mA. 


c=:> 


— ^ 


b)    Interfacing  an  LED  with  positive  logic.  A  logic  T  from  the  CPU  turns  the  LED  on. 


ci    interfacing  an  LED  with  negative  logic.  A  logic  '0'  from  the  CPU  turns  the  LED  on.  The  driver  or  the  CPU 
mav  invert  the  logic  levels. 


Figure  11-15.  Interfacing  an  LED 
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Object  Program: 


IViciMUfy  uiJuaUUII 

iViciMUiy  ^-'UtiLtJIHO 

I  nctri  iption 
1  Mo  11  Uu  LiUI  1 

(Hex) 

\lVI  I  itSi  1  lUI  MLi/ 

(form  data  initially) 

0000 

3E 

LD 

A.00001111B 

0001 

OF 

0002 

D3 

OUT 

(PIOCRB),A 

0003 

PIOCRB 

0004 

3E 

LD 

A.MASKP 

0005 

MASKP 

0006 

D3 

OUT 

(PIODRB), A 

0007 

PIOuRB 

0008 

76 

\u  puct  It?  uo  la/ 

HALT 

0009 

DB 

IN 

A,  (PIODRB) 

OOOA 

PIODRB 

OOOB 

CB 

SET 

LED.A 

OOOC 

LED 

OOOD 

D3 

OUT 

(PIODRB),A 

OOOE 

PIODRB 

OOOF 

76 

HALT 

B.    Send  a  Logic  Zero  to  the  LED  (turn  a  positive  display  off  or  a  negative  display  on). 


The  differences  are  that  MASKP  must  be  replaced  by  its  logical  complement 
MASKN  and  SET  LED.A  must  be  replaced  by  RES  LED.A.  Note  that  the  second  byte 
of  the  object  code  for  SET  LED.A  and  RES  LED.A  depends  on  the  actual  bit  position 
to  which  the  name  LED  refers. 

MASKN  has  a  zero  bit  in  the  LED  position  and  ones  elsewhere. 
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From.  CPU 


{Common-  (Common- 
may  be  used  for  decimal  pofnt  LED.  Cathode)  Anodel 


Figure  11-16.  Interfacing  a  Seven-Segment  Display 
Seven-Segment  LED  Display 

Purpose:  To  interface  a  seven-segment  LED  display  to  a  Z80  microprocessor.  The  dis- 
play may  be  either  common-anode  (negative  logic)  or  common-cathode 
(positive  logic). 

Circuit  Diagram: 

Figure  11-16  shows  the  circuitry  required  to  interface  a  COMMON-AI^ODE 
seven-segment  display.  Each  segment  may  have  one.  two,  OR 
or  more  LEDs  attached  in  the  same  way.  There  are  two  COMMON-CATHODE 
ways  of  connecting  the  displays.  One  is  tying  all  the  DISPLAYS 
cathodes  together  to  ground  (see  Figure  11-17a):  this  is  a 

"common-cathode"  display.  Tying  all  the  anodes  together  to  a  positive  voltage  supply 
(see  Figure  1 1-1 7b)  is  a  "common-anode"  display,  and  a  logic  zero  at  a  cathode  lights  a 
segment.  So  the  common-cathode  display  uses  positive  logic  and  the  common-anode 
display  negative  logic.  Either  display  requires  appropriate  drivers  and  resistors. 

The  Common  line  from  the  display  is  tied  either  io  ground  or  to  -1-5  volts.  The  display 
segments  are  customarily  labelled: 


f  b 


g 

e  c 


d 
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aj  Common-cathode 

g  O  


f  o  vw- 


e  o  ^AA>- 


d  O  WA*- 


c  O  "WV*- 

b  O  wv- 


b)   Common -anode  +  5V 

Q 


90— — — — 


fO  wv- 


eO— — — 


dO  WVr- 


cQ  VW- 


bO  »>AAr- 


a  O 


Figure  11-17.  Seven-Segment  Display  Organization 
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Table  1 1-4.  Seven-Segment  Representations  of  Decimal  Numbers 


Hexadecimal  Representation 

Common-cathode 

Common-anode 

0 

Or 

1 

06 

79 

2 

5B 

24 

o 
o 

4F 

30 

4 

66 

19 

5 

6D 

12 

6 

7D 

02 

7 

07 

78 

8 

7F 

00 

9 

67 

18 

Bit  7  is  always  zero  and  the  others  are  g,  f,  e,  d,  c,  b,  and  a  in  decreasing  order  of 
significance. 


Note:  The  seven-segment  display  is  widely  used  because  it  SEVEN-SEGMENT 
contains  the  smallest  number  of  separately  controlled  seg-  REPRESENTATIONS 

ments  that  can  provide  recognizable  representations  of  all 

the  decimal  digits  Isee  Figure  11-18  and  Table  11-4).  Seven-segment  displays  can  also 
produce  some  letters  and  other  characters  (see  Table  1 1  -6).  Better  representations  re- 
quire a  substantially  larger  number  of  segments  and  more  circuitry. ^  Since  seven-seg- 
ment displays  are  so  popular,  low-cost  seven-segment  decoder/drivers  have  become 
widely  available.  The  most  popular  devices  are  the  7447  common-anode  driver  and  the 
7448  common-cathode  driver^:  these  devices  have  Lamp  Test  inputs  (that  turn  all  the 
segments  on)  and  blanking  inputs  and  outputs  (for  blanking  leading  or  trailing  zeros). 
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0:  Segments  f,  e,  d.  c,  b.  a  on 


3:  Segments  g,  d.  c,  b,  a  on 


Segments  c.  b  on 


4:  Segments  g,  f .  c.  b  on 


2:  Segments  g,  e.  d,  b.  a  cm 


5:  Segments  g,  f,  d,  c,  a  on 
a 


Figure  11-18.  Seven-Segment  Representations  of  Decimal  Digits 
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6:  Segments  g,  f.  e,  d.  c,  a  on 


Note  that  the  aflemate  reprasantaiion  with  _a_off  may 
be  reMrved  for  the  lower  case  letter  "b'. 


7:  Segments  c.  b,  a  on 


8:  Segments  g.  f.  e.  d,  c.  b,  a 


This  is  the  same  as  LAMP  TEST. 


9:  Segments  g,  f,  c,  b,  a  on 


An  alternate  has  segment  d  on  also. 


Figure  11-18.  Seven-Segment  Representations  of  Decimat  Digits 
(Continued) 
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Table  11-5.  Seven-Segment  Representations  of  Letters  and  Symbols 


Upper-case  Letters 


Letter 

Hexadecimal  Representation 

Common-cathode 

Common-anode 

A 

77 

08 

C 

oy 

E 

79 

06 

F 

71 

OE 

H 

76 

09 

1 

06 

79 

J 

IE 

61 

L 

38 

47 

0 

3F 

40 

P 

73 

OC 

U 

3E 

41 

Y 

66 

19 

Lower-case  Letters  and  Special  Characters 

Character 

Hexadecimal  Representation 

Common-cathode 

Common-anode 

b 

70 

03 

c 

58 

27 

d 

5E 

21 

h 

74 

OB 

n 

54 

2B 

0 

5C 

23 

r 

50 

2F 

u 

1C 

63 

40 

3F 

? 

53 

2C 
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Task  1:  Display  a  decimal  digit. 

Purpose:  Display  the  contents  of  memory  location  0040  on  a  seven-segment  display  if 
it  contains  a  decimal  digit.  Otherwise,  blank  the  display. 

Sample  Problems: 

a.  (0040)  =  05 

Result  IS  5  on  display 

b.  (0040)  =  66 

Result  is  a  blank  display 
Flowchart: 


Start 


Code 

=  Bank 

Data  - 

=  (0040) 

Code  =  (SSEG  -f- 
Data) 


Send  code 
to  display 


C 
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Source  Program: 


LD 

A.00001 11 1 B 

:MAKE  PORT  B  OUTPUT 

r\t  IT 

1  r\ 
LU 

d.dLANn 

•  r'CT  Dl  AMi^  r^r\r\c 
.(jcl  dLANn  LUUt 

LD 

A,(4UH) 

.CjtT  uAiA 

CP 

10 

.iO  r~iA"rA   A  nc^lh>lAi  rM/^l'n 

;lb  DATA  A  DECIMAL  Dlbl  1  ( 

JR 

NC, DSPLY 

:Nu,  DlbPLAY  BLANKb 

LD 

DE.SScb 

.uET  BAbh  AuUHcbo  Ur  bbVbN-bbtjMhN  1 

;  TABLE 

LD 

H,0 

:MAKE  DATA  INTO  16-BIT  INDEX 

LD 

L,A 

ADD 

HL.DE 

lACCESS  ELEMENT  IN  TABLE 

LD 

B,!HL) 

■■GET  SEVEN-SEGMENT  CODE 

DSPLY;  LD 

A,B 

OUT 

(PIODRBl.A 

:SEND  CODE  TO  DISPLAY 

HALT 

BLANK  is  00  for  a  common-cathode  display,  FF  for  a  common-anode  display.  An  alter- 
native procedure  would  be  to  put  the  blank  code  at  the  end  of  the  table  and  replace  all 
improper  data  values  with  10,  i.e.. 


LD 

A,(40H) 

;GET  DATA 

CP 

10 

:IS  DATA  A  DECIMAL  DIGIT? 

JR 

CCNVRT 

:YES,  CONVERT  DIRECTLY  TO  SEVEN-SEGMENT 

LD 

A,10 

;N0,  GET  INDEX  FOR  BLANK  CODE 

LD 

DESSEG 

:GET  BASE  ADDRESS  OF  SEVEN-SEGMENT  TABLE 

Table  SSEG  is  either  the  common-cathode  or  common-anode  representation  of  the 
decimal  digits  from  Table  11-4. 
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Object  Program: 


Memory  Location 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

nnnn 

uuuu 

OC 

LD 

A.00001111B 

nnm 

np 

nnno 
uuuz 

OUT 

(PIOCRB},A 

nnriA 

\J\JKJH 

nfi 

LD 

B.BLANK 

nnnp; 

uUUD 

Dl  AMI/ 

UUUD 

Q  A 
OA 

LD 

A.(40H} 

uuu/ 

nnnp 
uuuo 

nn 
uu 

nnno 
uuuy 

CP 

rt 

CP 

10 

UUUA 

nA 

nnnn 

'^n 

JR 

NCDSPLY 

np 

nnnn 
uuuu 

1 1 

LD 

DE.SSEG 

nnnp 
uuut 

on 

nnnp 

no 

nnm 

/.u 

LD 

H.O 

001 1 

00 

0012 

6F 

LD 

LA 

0013 

19 

ADD 

HLDE 

0014 

46 

LD 

B.(HU 

0015 

78 

DSPLY: 

LD 

A.B 

0016 

D3 

OUT 

{PIODRB).A 

0017 

PIODRB 

0018 

76 

HALT 

0020-0029 

SSEG: 

(seven-segment  code 

table) 

Several  displays  may  be  multiplexed,  as  shown  in  Figure  11-19.  A  brief  strobe  on  the  B 
RDY  line  clocks  the  counter  and  directs  data  to  the  next  display.  Note  that  B  RDY  is  tied 
directly  back  to  B  STB,  i.e..  the  ready  line  essentially  provides  its  own  acknowledgment. 
The  timing  of  the  PIO  is  such  that  this  connection  results  in  a  strobe  with  a  duration  of 
one  clock  period.  Such  a  brief  strobe  is  exactly  what  the  counter  requires.  RESET  starts 
the  decimal  counter  at  nine  so  that  the  first  output  operation  clears  the  counter  and 
directs  data  to  the  first  display. 

The  following  program  uses  the  delay  routine  to  pulse  each  of  ten  common-cathode 
displays  for  1  ms. 
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D.  C.  B,  and  A  (D  most  sfgnificant,  A 
least  Significant!  are  the  4-bit  output 
from  the  counter.  These  4  bits  activate 
the  correspondingiy  numbered  output 
from  the  decoder,  and  hence  the  cor- 
respondingly numbered  display. 


Dock 

Decade 

C 

Counter 

B 

Reset 

9876543210 


4  to  10 
Decoder/Dnver 


Figure  11-19.  Multiplexed  Seven-Segment  Displays 
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Task  2:  Display  ten  decimal  digits. 

Purpose:  Display  the  contents  of  memon/  locations  0040  through  0049  on  ten  7-seg- 
ment  displays  that  are  multiplexed  with  a  counter  and  a  decoder. 

Sample  Problem: 

(0040)  =  66 

(0041)  =  3F 

(0042)  =  7F 

(0043)  =  7F 

(0044)  =  06 

(0045)  =  5B 

(0046)  =  07 

(0047)  =  4F 

(0048)  =  6D 

(0049)  =  7D 

Display  reads  4088127356 


Source  Program: 


LD 

A,00001111B     :  MAKE  PORT  B  OUTPUT 

OUT 

(PIOCRB),A 

DRUN: 

LD 

HL,40H 

POINT  TO  START  OF  DATA 

LD 

B.10 

NUMBER  OF  DISPLAYS  =  10 

LD 

CPIODRB 

GET  PORT  NUMBER 

DSPLY; 

0UT1 

SEND  DATA  TO  DISPLAY 

CALL 

DELAY 

WAIT  1  MS 

JR 

NZ.DSPLY 

COUNT  DISPLAYS 

JR 

DRUN 

START  ANOTHER  SCAN 

,  Here  we  must  select  the  PIO  output  mode,  since  the  circuit  uses  the  handshake  signals. 

Note  that  OUTI  sends  the  data  to  the  output  port  addressed  by  Register  C.  increments 
the  address  in  Register  Pair  ML,  and  decrements  the  counter  in  Register  B.  We  have 
assumed  that  subroutine  DELAY  does  not  affect  the  Z  flag  so  that  it  can  be  used  after- 
wards for  a  conditional  branch. 


11-53 


Object  Program: 


Memory  Address      Memory  Contents  Instruction 
(Hex)  (Hex)  (Mnemonic) 


0000  3E  LD  A.OOOOIIIIB 

0001  OF 

0002  D3  OUT  (PIOCRB).A 

0003  PIOCRB 

0004  21  DRUN;      LD  HL,40H 

0005  40 

0006  00 

0007  06  LD  8,10 

0008  OA 

0009  OE  LD  CPIODRB 
OOOA  PIODRB 

OOOB  ED  DSPLY;  OUTI 

OOOC  A3 

OOOD  CD  CALL  DELAY 

OOOE  30 

OOOF  00 

0010  20  JR  NZ,DSPLY 

001 1  F9 

0012  18  JR  DRUN 

0013  FO 
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PROBLEMS 

1)  An  On-Off  Pushbutton 

Purpose:  Each  closure  of  the  pushbutton  complements  (inverts)  all  the  bits  in  memory 
location  0040.  The  location  initially  contains  zero.  The  program  should  con- 
tinuously examine  the  pushbutton  and  complement  location  0040  with  each 
closure.  You  may  wish  to  complement  a  display  output  port  instead,  so  as  to 
make  the  results  easier  to  see. 

Sample  Case: 

Location  0040  initially  contains  zero. 

The  first  pushbutton  closure  changes  location  0040  to  FF  (hex),  the  second  changes  it 
back  to  zero,  the  third  back  to  FF  (hex),  etc.  Assume  that  the  pushbutton  is  debounced 
in  hardware.  How  would  you  include  debouncing  in  your  program? 

2)  Debouncing  a  Switch  in  Software 

Purpose:  Debounoe  a  mechanical  switch  by  waiting  until  two  readings,  taken  a  de- 
bounce  time  apart,  give  the  same  result.  Assume  that  the  debounce  time  (in 
ms)  is  in  memory  location  0040  and  place  the  switch  position  into  memory 
location  0041. 

Sample  Problem: 

(0040)  =  03  causes  the  program  to  wait  3  ms  between  readings. 

3)  Control  for  a  Rotary  Switch 

Purpose:  Another  switch  serves  as  a  Load  switch  for  a  four-position  unencoded  rotary 
switch.  The  CPU  waits  for  the  Load  switch  to  close  (be  zero),  and  then  reads 
the  position  of  the  rotary  switch.  This  procedure  allows  the  operator  to  move 
the  rotary  switch  to  its  final  position  before  the  CPU  tries  to  read  it.  The  pro- 
gram should  place  the  position  of  the  rotary  switch  into  memory  location 
0040.  Debounce  the  Load  switch  in  software. 

Sample  Problem: 

Place  rotary  switch  in  position  2.  Close  Load  switch. 
Result:    (0040)  =  02 
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4}   Record  Switch  Positions  on  Lights 

Purpose:  A  set  of  eight  switches  should  have  their  positions  reflected  in  eight  LEDs, 
That  is  to  say,  if  the  switch  is  closed  (zero),  the  LED  should  be  on,  otherwise 
the  LED  should  be  off.  Assume  that  the  CPU  output  port  is  connected  to  the 
cathodes  of  the  LEDs. 


Sample  Problem: 

SWITCH 

0 

CLOSED 

SWITCH 

1 

OPEN 

SWITCH 

2 

CLOSED 

SWITCH 

3 

OPEN 

SWITCH 

4 

OPEN 

SWITCH 

5 

CLOSED 

SWITCH 

6 

CLOSED 

SWITCH 

7 

OPEN 

Result: 

LED 

0 

ON 

LED 

1 

OFF 

LED 

2 

ON 

LED 

3 

OFF 

LED 

4 

OFF 

LED 

5 

ON 

LED 

6 

ON 

LED 

7 

OFF 

How  would  you  change  the  program  so  that  a  switch  attached  to  bit  7  of  Port  A  of  PIO 
#2  determines  whether  or  not  the  displays  are  active  (i.e.,  if  the  control  switch  is 
closed,  the  displays  attached  to  Port  B  reflect  the  switches  attached  to  Port  A;  if  the 
control  switch  is  open,  the  displays  are  always  off)?  A  control  switch  is  useful  when  the 
displays  may  distract  the  operator,  as  in  an  airplane. 

How  would  you  change  the  program  so  as  to  make  the  control  switch  an  on-off 
pushbutton;  that  is,  each  closure  reverses  the  previous  state  of  the  displays?  Assume 
that  the  displays  start  in  the  active  state  and  that  the  program  examines  and  debounces 
the  pushbutton  before  sending  data  to  the  displays. 

5)    Count  on  a  Seven-Segment  Display 

Purpose:  The  program  should  count  from  0  to  9  continuously  on  a  seven-segment  dis- 
play, starting  with  zero. 

Hint:  Try  different  timing  lengths  for  the  displays  and  see  what  happens.  When  does 
the  count  become  visible?  What  happens  if  the  display  is  blanked  part  of  the  time? 
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MORE  COMPLEX  I/O  DEVICES 


More  complex  I/O  devices  differ  from  simple  keyboards,  switches,  and  displays  in  that: 

1)  They  transfer  data  at  higher  rates. 

2)  They  may  have  their  own  internal  clocks  and  timing. 

3)  They  produce  status  information  and  require  control  information,  as  well  as 
transferring  data. 

Because  of  their  high  data  rates,  you  cannot  handle  these  I/O  devices  casually.  If  the 
processor  does  not  provide  the  appropriate  service,  the  system  may  miss  input  data  or 
produce  erroneous  output  data.  You  are  therefore  working  under  much  more  exacting 
constraints  than  in  dealing  with  simpler  devices.  Interrupts  are  a  convenient  method 
for  handling  complex  I/O  devices,  as  we  shall  see  in  Chapter  12. 

Peripherals  such  as  keyboards,  teletypewriters,  cassettes, 
and  floppy  disks  produce  their  own  internal  timing.  These 
devices  provide  streams  of  data,  separated  by  specific  tim- 
ing intervals.  The  computer  must  synchronize  the  initial  in- 
put or  output  operation  with  the  peripheral  clock  and  then  provide  the  proper  interval 
between  subsequent  operations.  -A  simple  delay  loop  like  the  one  shown  previously  can 
produce  the  timing  interval.  The  synchronization  may  require  one  or  more  of  the  follow- 
ing procedures: 

1 )  Looking  for  a  transition  on  a  clock  or  strobe  line  provided  by  the  peripheral  for  tim- 
ing purposes.  A  simple  approach  would  be  to  tie  the  strobe  to  a  PIO  STB  input  and 
look  for  a  change  in  the  interrupt  (INT)  output.  However,  there  is  no  way  to  directly 
address  the  INT  output  (and  thus  determine  its  value)  and  no  way  to  clear  it  other 
than  through  an  interrupt  service  routine.  Thus,  to  use  the  PIO  in  a  polling  system, 
one  must  make  the  strobe  available  at  an  input  port  and  latch  it  if  necessary,  if  the 
strobe  must  be  latched,  a  circuit  must  also  be  provided  to  clear  the  latch  as  part  of 
the  subsequent  input  or  output  transfer. 

2)  Finding  the  center  of  the  time  interval  during  which  the  data  is  stable.  We  would 
prefer  to  determine  the  value  of  the  data  at  the  center  of  the  pulse  rather  than  at 
the  edges,  where  the  data  may  be  changing.  Finding  the  center  requires  a  delay  of 
one-half  of  a  transmission  interval  (bit  time)  after  the  edge.  Sampling  the  data  at 
the  center  also  means  that  small  timing  errors  have  little  effect  on  the  accuracy  of 
the  reception. 

3)  Recognizing  a  special  starting  code.  This  is  easy  if  the  code  is  a  single  bit  or  if  we 
have  some  timing  information.  The  procedure  is  more  complex  if  the  code  is  long 
and  could  start  at  any  time.  Shifting  will  be  necessary  to  determine  where  the 
transmitter  is  starting  its  bits,  characters,  or  messages  (this  is  often  called  a  search 
for  the  correct  "framing"). 

4)  Sampling  the  data  several  times.  This  reduces  the  probability  of  receiving  data  in- 
correctly from  noisy  lines.  Maiority  logic  (such  as  best  3  out  of  5  or  5  out  of  8)  can 
be  used  to  decide  on  the  actual  data  value. 

Reception  is,  of  course,  much  more  difficult  than  transmission,  since  the  peripheral  con- 
trols the  reception  and  the  computer  must  interpret  timing  information  generated  by 
the  peripheral.  In  transmission,  the  computer  provides  the  proper  timing  and  formatting 
for  a  specific  peripheral. 

Peripherals  may  require  or  provide  other  information  besides 
data  and  timing.  We  refer  to  other  information  transmitted  by 
the  computer  as  "control  information",  it  may  select  modes  of 
operation,  start  or  stop  processes,  clock  registers,  enable 
buffers,  choose  formats  or  protocols,  provide  operator  displays,  count  operations,  or 


SYNCHRONIZING 
WITH  I/O 
DEVICES 


CONTROL 
AND  STATUS 
INFORMATION 
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identify  the  type  and  priority  of  the  operation.  We  refer  to  other  information  transmitted 
by  the  peripheral  as  "status  information";  it  may  indicate  the  mode  of  operation,  the 
readiness  of  devices,  the  presence  of  error  conditions,  the  format  of  protocol  in  use,  and 
other  states  or  conditions. 

The  computer  handles  control  and  status  information  just  like  data.  This  information 
seldom  changes,  even  though  actual  data  may  be  transferred  at  a  high  rate.  The  control 
or  status  information  may  be  single  bits,  digits,  words,  or  multiple  words.  Often  single 
bits  or  short  fields  are  combined  and  handled  by  a  single  input  or  output  port. 

Combining  status  and  control  information  into  bytes  reduces  the  total  number  of  I/O 
port  addresses  required  by  the  peripherals.  However,  the  combination  does  mean  that 
individual  status  input  bits  must  be  separately  interpreted  and  control  output  bits  must 
be  separately  determined.  The  procedures  for  isolating  status  bits  and  setting  or  reset- 
ting control  bits  are  as  follows; 

Separating  Out  Status  Bits 
Step  1)    Read  status  data  from  the  peripheral 
Step  2)    Logical  AND  with  a  mask  (the  mask  has  ones  in  bit 

positions  that  must  be  examined  and  zeros 

elsewhere) 

Step  3)   Shift  the  separated  bits  to  the  least  significant  bit  positions 

If  the  field  is  a  single  bit.  Step  2  is  unnecessary  since  we  can  test  the  bit  with  the  BIT  in- 
struction. If  the  single  bit  is  in  the  most  significant,  next  to  most  significant,  or  least  sig- 
nificant position,  we  can  use  shift  logical  (AND  .A  or  OR  A)  instructions  to  determine  its 
value.  Remember  also  that  the  input  instructions  with  register  indirect  addressing  (e.g.. 
IN  A,(C))  affect  the  Sign  flag.  These  somewhat  more  accessible  bit  positions  are  often 
reserved  for  the  most  frequently  used  status  information.  You  should  try  to  write  the  re- 
quired instruction  sequences  for  the  Z80  processor. 

Step  3  is  unnecessary  if  the  field  is  a  single  bit,  since  the  Zero  flag  will  contain  the  com- 
plement of  that  bit  after  Step  2  (try  it!).  A  Shift  or  Load  instruction  can  replace  Step  2  if 
the  field  is  a  single  bit  and  occupies  the  least  significant,  most  significant,  or  next  to 
most  significant  bit  position.  These  positions  are  often  reserved  for  the  most  frequently 
used  status  information.  You  should  try  to  write  the  required  instruction  sequences  for 
the  6800  processor. 

Setting  and  Clearing  Control  Bits 
Step  1)    Read  prior  control  information 
Step  2)    Logical  AND  with  mask  to  clear  bits  (mask  has  zeros 

in  bit  positions  to  be  cleared,  ones  elsewhere) 
Step  3)    Logically  OR  with  mask  to  set  bits  (mask  has  ones  in  bit  positions  to  be  set, 

zeros  elsewhere) 
Step  4)    Send  new  control  information  to  peripheral 

Here  again  the  procedure  is  simpler  if  the  field  is  a  single  bit  and  occupies  a  position  at 
the  end  of  the  word. 


SEPARATING 

STATUS 

INFORMATION 


COMBINING 

CONTROL 

INFORMATION 
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Some  examples  of  separating  and  combining  status  bits  are: 

1)  A  3-bit  field  in  bit  positions  2  through  4  of  a  PIO  data  register  is  a  scaling  factor. 
Place  that  factor  into  the  Accumulator. 

,  READ  STATUS  DATA  FROM  INPUT  PORT 

IN  A,(PIQDR)  :READ  STATUS  DATA 

:  MASK  OFF  SCALING  FACTOR  AND  SHIFT 

AND        00011100B       .;MASK  SCALING  FACTOR 
RRCA  iSHIFT  TWICE  TO  NORMALIZE 

RRCA 

2)  The  Accumulator  contains  a  2-bit  field  that  must  be  placed  into  bit  positions  3  and 
4  of  a  PIO  data  register. 

;  MOVE  DATA  TO  FIELD  POSITIONS 


RLA  :SHIFT  DATA  TO  BIT  POSITIONS  3  AND  4 

RLA 

RLA 

AND        000110008        .CLEAR  OTHER  BIT  POSITIONS 
LD  B.A  :SAVE  NEW  FIELD  VALUE 

,  COMBINE  NEW  FIELD  VALUE  WITH  OTHER  DATA 

IN  A,(PIODRI  iCLEAR  OLD  FIELD  VALUE 

AND        11 10011  IB 

OR  B  : INSERT  NEW  FIELD  VALUE 

OUT  (PIODR),A 

Documentation  is  a  serious  problem  in  handling  control  and  DOCUMENTING 
status  information.  The  meanings  of  status  inputs  or  control        STATUS  AND 
outputs  are  seldom  obvious.  The  programmer  should  clearly  in-  CONTROL 
dioate  the  purposes  of  input  and  output  operations  in  the  com-  TRANSFERS 
ments.  e.g..  "CHECK  IF  READER  IS  ON,"  "CHOOSE  EVEN 

PARITY  OPTION,"  or  "ACTIVATE  BIT  RATE  COUNTER."  The  bit  manipulation.  Logical, 
and  Shift  instructions  will  otherwise  be  very  difficult  to  remember,  understand,  or 
debug. 
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Table  11-6.  Comparison  Between  Independent  Connections 
and  Matrix  Connections  for  Keyboards 


Keyboard  Size 

Nunnber  of  Lines  with 
Independent  Connections 

Number  of  Lines  with 
Matrix  Connections 

3x3 

9 

6 

4x4 

16 

8 

4x6 

24 

10 

5x5 

25 

10 

6x6 

36 

12 

6x8 

48 

14 

8x8 

64 

16 

EXAMPLES 

An  Unencoded  Keyboard 

Purpose:  Recognize  a  key  closure  from  an  unencoded  3x3  keyboard  and  place  the 
number  of  the  key  that  was  pressed  into  the  Accumulator. 

Keyboards  are  just  collections  of  switches  (see  Figure  1 1  -20).  Small  numbers  of  keys  are 
easiest  to  handle  if  each  key  is  attached  separately  to  a  bit  of  an  input  port.  Interfacing 
the  keyboard  is  then  the  same  as  interfacing  a  set  of  switches. 

Keyboards  with  more  than  eight  keys  require  more  than  one  input 
port  and  therefore  multibyte  operations.  This  is  particularly 
wasteful  if  the  keys  are  logically  separate,  as  in  a  calculator  or  ter- 
minal keyboard  where  the  user  will  only  strike  one  at  a  time.  The  number  of  input  lines 
required  may  be  reduced  by  connecting  the  keys  into  a  matrix,  as  shown  in  Figure 
1 1-21.  Now  each  key  represents  a  potential  connection  between  a  row  and  a  column. 
The  keyboard  matrix  requires  n  -I-  m  external  lines,  where  n  is  the  number  of  rows  and 
m  is  the  number  of  columns.  This  compares  to  n  x  m  external  lines  if  each  key  is  sepa- 
rate. Table  11-6  compares  the  number  of  keys  required  by  typical  configurations. 

-A  program  can  determine  which  key  has  been  pressed  by  using        j  KEYBOARD 
the  external  lines  from  the  matrix.  The  usual  procedure  is  a        I  SCAM 
"keyboard  scan."  We  ground  Row  0  and  examine  the  column 
lines.  If  any  lines  are  grounded,  a  key  in  that  row  has  been  pressed,  causing  a  row-to- 
oolumn  connection.  We  can  determine  which  key  was  pressed  by  determining  which 
column  line  is  grounded:  that  is,  which  bit  of  the  input  port  is  zero.  If  no  column  line  is 
grounded,  we  proceed  to  Row  1  and  repeat  the  scan.  Note  that  we  can  check  to  see  if 
any  keys  at  all  have  been  pressed  by  grounding  all  the  rows  at  once  and  examining  the 
columns. 

The  keyboard  scan  requires  that  the  row  lines  be  tied  to  an  output  port  and  the  column 
lines  to  an  input  port.  Figure  1 1-22  shows  the  arrangement  The  CPU  can  ground  a  par- 
ticular row  by  placing  a  zero  in  the  appropriate  bit  of  the  output  port  and  ones  in  the 
other  bits. 

The  CPU  can  determine  the  state  of  a  particular  column  by  examining  the  appropriate 
bit  of  the  input  port. 


MATRIX 

KEYBOARD 
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Kev  1 

± 

o  o 


Kay  2 

± 

o  o 


Key  3 


8  O      O  ( I 


Each  ksv  IS  a  switch  iust  like  a  pushbutton  and  grounds  an  input  bit  if  it  is  pressed. 


Figure  11-20.  A  Small  Keyboard 


Column  0  Column  1  Column  2 


KeyO.  1 

,      Key  2  \^  ^ 

» 

Key  3  V  f 

w 

 ^ 

 ^ 

Keye^^ 
 ^ 

»     Key  8  ^ 

 ^ 

> 

Each  key  now  serves  to  connect  a  row  to  a  column.  For  instance,  key  4  connects  row  1  to  column  t. 


Figure  11-21.  A  Keyboard  Matrix 
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Column  0  Column  1  Coiumn  2 


Data  Bus 
(from  CPU) 


HO 

Output  Oi 
Port 


02 


— 


Kev  3 


V4 


Kev  6 


Key  1 


Kev  4 


y4 


Kev  5 


V4 

 ■ 


l2 

PIO 

Input 

Port 

Data  Bus  (to  CPUl 


Figure  1 1-22.  I/O  Arrangement  for  a  Keyboard  Scan 
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Task  1:  Determine  key  closure. 
Purpose:  Wait  for  a  key  to  be  pressed. 
The  procedure  is  as  follows; 

1)  Ground  all  the  rows  by  clearing  all  the  output  bits. 

2)  Fetch  the  column  inputs  by  reading  the  input  port. 

3)  Return  to  Step  1  if  all  the  column  inputs  are  ones. 
Flowchart: 


WAITING 
FOR  A 

KEY  CLOSURE 


c 


Ground 
kevtK»rd  rows 


Source  Program: 


WAITK; 


LD 

A,01001111B 

:MAKE  PORT  A  INPUT 

OUT 

(PIOCRA).A 

LD 

A.oooomiB 

:MAKE  PORT  B  OUTPUT 

OUT 

(PIOCRB),A 

SUB 

A 

:GROUND  ALL  KEYBOARD  ROWS 

OUT 

(PIODRBl.A 

IN 

A.(PIODRA) 

:GET  KEYBOARD  COLUMN  DATA 

AND 

0000011  IB 

:MASK  COLUMN  BITS 

CP 

0000011  IB 

:ARE  ANY  COLUMNS  GROUNDED? 

JR 

Z,  WAITK 

;N0,  WAIT  UNTIL  ONE  IS 

HALT 
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Object  Program: 


Memorv  Location 

Memory  Contents 

Instruction 

\nex/ 

(Mnemonic) 

0000 

3E 

LD 

A.01001111B 

0001 

4F 

0002 

D3 

OUT 

(PIOCRAj.A 

0003 

PIOCRA 

0004 

3E 

LD 

A.OOOOllllB 

0005 

OF 

0006 

D3 

OUT 

SPIOCRBl.A 

0007 

PIOCRB 

0008 

97 

SUB 

A 

0009 

D3 

OUT 

(PIODRBl.A 

OOOA 

PIODRB 

OOOB 

DB 

WAITK;  IN 

A.(PIODRA) 

r  Iwt-TIM 

OOOD 

E6 

AND 

0000011  IB 

OOOE 

07 

OOOF 

FE 

CP 

0000011  IB 

0010 

07 

0011 

28 

JR 

Z.WAITK 

0012 

F8 

0013 

76 

HALT 

PIO  Port  8  IS  the  keyboard  output  port  and  Port  A  is  the  input  port. 


Masking  off  the  column  bits  eliminates  any  problems  that  could  be  caused  by  the  states 
of  the  unused  input  lines. 

We  could  generalize  the  routine  by  naming  the  output  and  masking  patterns: 
ALLG       EQU  111110008 
OPEN       EQU        0000011  IB 

These  names  could  then  be  used  in  the  actual  program;  a  different  keyboard  would  re- 
quire only  a  change  in  the  definitions  and  a  re-assembly. 

Of  course,  one  port  of  a  PIO  is  all  that  is  really  necessary  for  a  3  x  3  or  4  x  4  keyboard. 
Try  rewriting  the  program  so  that  it  uses  only  Port  A.  The  PIO  must  be  placed  into  the 
control  mode  so  that  lines  can  be  individually  selected  as  inputs  or  outputs. 
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Task  2:  Identify  key. 

Purpose:  Identify  a  key  closure  by  placing  the  number  of  the  key  into  the  Accumulator. 
The  procedure  is  as  follows: 

1)  Set  key  number  to  -1,  counter  to  number  of  rows,  and  output  pattern  to  all  ones 
except  for  a  zero  in  bit  0. 

2)  Ground  a  row  by  sending  the  output  pattern  to  the  keyboard  output  port. 

3)  Update  the  output  pattern  by  shifting  the  zero  bit  left  one  position. 
4!    Fetch  the  column  inputs  by  reading  the  input  port. 

5)  If  any  column  inputs  ai'e  zero,  proceed  to  Step  8. 

6)  Add  the  number  of  columns  to  the  key  number  to  reach  the  next  row. 

7)  Decrement  counter.  Go  to  Step  2  if  any  rows  have  not  been  scanned,  otherwise  to 
Step  10. 

8)  Add  1  to  key  number.  Shift  column  inputs  right  one  bit. 

9)  If  Carry  =  1.  return  to  Step  8. 
10)    End  of  program. 
Flowchart; 


Kev  Number  =  -  1 
Counter  =  Number 
„  „  of  rows 
Scan  Pattern  = 

11111110 


Ground  row  by 
output  of 
Scan  Pattern 
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Source  Program: 

LD  A.OIOOIIIIB  :MAKE  PORT  A  INPUT 

OUT  (PIOCRAj.A 

LD  A.00001 1 1 1 B  :MAKE  PORT  B  OUTPUT 

OUT  (PIOCRBl.A 

LD  B.3  :COUNT  =  NUMBER  OF  ROWS 

LD  CPIODRB  :GET  OUTPUT  PORT  NUMBER 

LD  0,3  ;GET  NUMBER  OF  COLUMNS 

LD  E,1 11 1 1 1 108  :START  SCAN  PATTERN  TO  GROUND  ROW 
;  ZERO 

LD  H.000001 1 1 B  -.GET  KEYBOARD  MASKING  PATTERN 

LD  L.OFFH  :KEY  NUMBER  =  -1 

FROW:     OUT  (C),E  -.SCAN  A  ROW 

RLC  E  ;UPDATE  SCAN  PATTERN  FOR  NEXT  ROW 

IN  A,(PIODRA)  ;GET  KEYBOARD  COLUMN  DATA 

AND  H  :MASK  COLUMN  BITS 

CP  H  :ARE  ANY  COLUMNS  GROUNDED? 

JR  NZ.FCOL  ;YES.  GO  FIND  WHICH  ONE 

LD  A,L  -.NO,  UPDATE  KEY  NUMBER  FOR  NEXT  ROW 

ADD  A,D 

LD  LA 

DJNZ  FROW  lEXAMINE  NEXT  ROW  IF  ANY  LEFT 

INC  L  ;IDENTIFY  CASE  IN  WHICH  KEY  NOT  FOUND 

JR  DONE 

FCOL:      INC  L  INCREMENT  KEY  NUMBER 

RRA  ;IS  THIS  COLUMN  GROUNDED? 

JR  NC.FCOL  -.NO,  EXAMINE  NEXT  COLUMN 

DONE:  HALT 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

!Hex) 

(Hex) 

(Mnemonic) 

uuuu 

LD 

A.01001111B 

nnni 

UUU  1 

AP 

uo 

OUT 

(PIOCRA).A 

"^p 

LD 

A.00001111B 

UUUD 

np 
Ur 

UUUD 

lJv5 

OUT 

(PIOCRBj.A 

nnnv 

UUU/ 

r  lUunD 

Anno 
uuuo 

nR 

UD 

LD 

8,3 

uuuy 

n'5 
uo 

nan  A 

UUUM 

np 

Ut 

LD 

C.PIODRB 

UUUD 

rlUUno 

uuuu 

1 R 

LD 

D,3 

nnnn 

uuuu 

uo 

uuut 

1  p 

LD 

E,11111110B 

UUUr 

PC 

re 

UU  1  u 

LD 

H.OOOOOIIIB 

UU  t  i 

n7 

u  / 

UU  i  Z 

9P 

LD 

L.  OFFH 

UU  1  o 

pp 

rr 

nni  A 

UU  l*f 

pn 

PRO\A/- 
rnUVV : 

OUT 

(C),E 

nni  p; 

UU  i  D 

p;q 
oy 

nni  R 

UU  i  D 

PR 

RLC 

E 

nni  7 

UU  1  / 

n'5 
uo 

nni  £5 
uU !  c3 

nR 

L/D 

IN 

A.iPIODRA) 

nni  Q 
UU  1  y 

rtUUnA 

nni  A 
UU  !  A 

AA 

AND 

H 

nni  R 

UU  1  D 

RP 

CP 

H 

nni  c 

UU  t 

9n 
zu 

JR 

NZ.FCOL 

nni  n 

UU  1  u 

nA 
uo 

nni  P 

UU  1  t 

7n 
/  u 

LD 

A,L 

nni  c 

UU  1  r 

R9 

oz 

ADD 

A,D 

nn9n 
uuzu 

fip 

Or 

LD 

L,A 

nnoi 

UUZ  1 

1  n 

1  u 

DJNZ 

FROW 

nn99 

UUZ<1. 

PI 
r  1 

0023 

2C 

INC 

L 

0024 

18 

JR 

DONE 

0025 

04 

0026 

2C 

FCOL: 

INC 

L 

0027 

IF 

RRA 

0028 

30 

JR 

NCFCOL 

0029 

FC 

002A 

76 

HALT 

Each  time  a  row  scan  fails,  we  must  add  the  number  of  columns  to  the  kev  number  so 
as  to  move  past  the  present  row  (try  it  on  the  keyboard  in  Figure  1 1-22). 
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What  Is  the  result  of  the  program  if  no  keys  are  being  pressed?  Note  the  extra  INC  L  in- 
struction so  that  the  program  differentiates  between  no  keys  pressed  and  the  last  key 
being  pressed.  What  is  the  final  value  in  the  Accumulator  for  these  two  oases?  Note 
that  the  Zero  flag  could  also  be  used  to  distinguish  the  case  where  no  keys  were 
pressed.  Can  you  explain  how? 

An  alternative  approach  would  be  to  use  the  PIO  in  its  control  mode  so  that  lines  could 
be  changed  from  inputs  to  outputs.  The  procedure  would  be: 

1)  Ground  all  the  columns  and  save  the  row  inputs. 

2)  Ground  all  the  rows  and  save  the  column  inputs. 

3)  Use  the  row  and  column  inputs  together  to  determine  the  key  number  from  a  table. 
Try  to  write  a  program  to  implement  this  procedure. 

This  program  can  be  generalized  by  making  the  numbef  of  rows,  the  number  of  col- 
umns, and  the  masking  pattern  into  named  parameters  with  EQU  pseudo-operations. 
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Ao 
A7 


Keyboard  Data  Inputs 


Data  Sus 
to  CPU 


PIO 


A  STB 


B4 


Keyboard  Strobe 


Figure  11-23.  I/O  Interface  for  an  Encoded  Keyboard 


An  Encoded  Keyboard 

Purpose:  Fetch  data,  when  it  is  available,  from  an  encoded  keyboard  that  provides  a 
strobe  along  with  each  data  transfer. 

An  encoded  keyboard  provides  a  unique  code  for  each  key.  It  has  internal  electronics 
that  perform  the  scanning  and  identification  procedure  of  the  previous  example.  The 
tradeoff  is  between  the  simpler  software  required  by  the  encoded  keyboard  and  the 
lower  cost  of  the  unencoded  keyboard. 

Encoded  keyboards  may  use  diode  matrices,  TTL  encoders,  or  MOS  encoders.  The 
codes  may  be  ASCII.  EBCDIC,  or  a  custom  code.  PROMs  are  often  part  of  the  encoding 
circuitry. 

The  encoding  circuitry  may  do  more  than  iust  encode  key         |  ROLLOVER  | 

closures.  It  may  also  debounce  the  keys  and  handle  "rollover,"  the 
problem  of  more  than  one  key  being  struck  at  the  same  time.  Common  ways  of  han- 
dling rollover  are:  "2-key  rollover."  whereby  two  keys  (but  not  more)  struck  at  the  same 
time  are  resolved  into  separate  closures,  and  "n-key  rollover."  whereby  any  number  of 
keys  struck  at  the  same  time  are  resolved  into  separate  closures. 

The  encoded  keyboard  also  provides  a  strobe  with  each  data  transfer.  The  strobe  sig- 
nals that  a  new  closure  has  occurred.  Figure  1 1-23  shows  the  interface  between  an  en- 
coded keyboard  and  the  Z80  microprocessor.  The  rising  edge  of  the  strobe  latches  the 
data  into  the  input  port.  We  also  tie  the  strobe  to  the  B  side  of  the  PIO  so  that  the  CPU 
can  determine  when  a  rising  edge  has  occurred.  Of  course,  the  B  port  of  one  PIO  could 
hold  status  signals  from  up  to  eight  ports.  The  software  would  then  have  to  determine 
which  ports  were  active  with  a  shifting  and  masking  operation. 

We  have  assumed  m  the  program  that  the  strobe  signal  is  long  enough  for  the  CPU  to 
handle  it  in  software.  If  it  is  not,  the  signal  will  have  to  be  latched  and  cleared  (with 
RDY)  when  the  input  or  output  transfer  occurs. 

You  may  have  to  watch  the  polarity  of  the  strobe,  since  the  PIO  always  reacts  to  a  rising 
edge.  An  inverter  gate  may  be  necessary. 
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Task:  Input  from  keyboard. 

Purpose:  Wait  for  the  rising  edge  of  a  strobe  at  tlie  B  port  of  a  PIO  and  then  place  the 
data  from  Port  A  into  the  Accumulator. 

Flowchart: 


c 


The  hardware  must  hold  the  control 
accidental  setting  of  status  flags. 

Source  Program: 


ines  in  a  logic  one  state  during  reset  to  prevent  the 


SRCHL: 


SRCHH: 


LD 

A,01001111B 

MAKE  PORT  A  INPUT 

OUT 

(PIOCRAI.A 

LD 

A.IIOOIIIIB 

MAKE  PORT  B  CONTROL 

OUT 

(PIOCRBl.A 

LD 

A.OFFH 

ALL  PORT  B  LINES  INPUTS 

OUT 

(PIOCRB),A 

IN 

A,(PIODRB) 

EXAMINE  STATUS  PORT 

BIT 

STB.A 

HAS  STROBE  LINE  GONE  LOW? 

JR 

NZ,SRCHL 

NO.  WAIT  UNTIL  IT  HAS 

IN 

A.(PIODRB) 

EXAMINE  STATUS  PORT  AGAIN 

BIT 

STB.A 

RISING  EDGE  FOUND? 

JR 

Z,SRCHH 

NO.  WAIT  UNTIL  ONE  OCCURS 

IN 

A,(PIODRA) 

YES.  FETCH  DATA 

HALT 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

3E 

LD 

A.oioomiB 

0001 

4F 

0002 

D3 

OUT 

(PIOCRAI.A 

0003 

PIOCRA 

0004 

3E 

LD 

A,11001111B 

0005 

CF 

0006 

D3 

OUT 

(PIOCRB).A 

0007 

PIOCRB 

0008 

3E 

LD 

A.OFFH 

0009 

FF 

OOOA 

D3 

OUT 

(PIOCRBl.A 

OOOB 

PIOCRB 

OOOC 

DB 

SRCHL. 

IN 

A,  (PIODRB) 

OOOD 

PIODRB 

OOOE 

CB 

BIT 

STB.A 

OOOF 

STB 

0010 

20 

JR 

NZ.SRCHL 

001 1 

FA 

0012 

DB 

SRCHH: 

IN 

A,  (PIODRB) 

0013 

PIDDRB 

0014 

CB 

BIT 

STB.A 

0015 

STB 

0016 

28 

JR 

Z.SRCHH 

0017 

FA 

0018 

DB 

IN 

A,  (PIODRA) 

0019 

PIODRA 

001 A 

76 

HALT 

If  the  CPU  repeats  this  routine,  it  will  not  fetch  another  character  until  the  next  nsing 
edge  occurs  on  the  strobe  line.  A  continuing  high  level  on  the  strobe  line  will  be  ig- 
nored. 

STB  depends  on  which  bit  of  Port  B  is  used.  Figure  1 1-23  shows  bit  4  being  used,  but 
bits  0.  6,  and  7  are,  as  usual,  the  easiest  to  examine.  Try  rewriting  the  program  to  use 
the  more  accessible  bit  positions. 

The  second  byte  of  the  Bit  instructions  depends  on  the  value  of  STB  but  is  not  equal  to 
that  value.  For  example,  the  second  byte  is  4Fi6  if  STB  =  1.  57ig  if  STB  =  2.  etc. 
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A  Digital-to-Analog  Converter 

Purpose:  Send  data  to  an  8-bit  digital-to-analog  converter,  which  has  an  active-low 
latch  enable. 

Digital-to-analog  converters  produce  the  continuous  signals  required  bv  solenoids, 
relays,  actuators,  and  other  electrical  and  nnechanical  output  devices.  Typical  conver- 
ters consist  of  switches  and  resistor  ladders  with  the  appropriate  resistance  values.^ 
The  user  must  generally  provide  a  reference  voltage  and  some  other  digital  and  analog 
circuitry,  although  complete  units  are  becoming  available  at  low  cost. 

Figure  11-24  describes  the  8-bit  Signetics  NE5018  D/A  converter,  which  contains  an 
on-chip  8-bit  parallel  data  input  latch.  A  low  level  on  the_LE  (Latch  Enable)  input  gates 
the  input  data  into  the  latches,  where  It  remains  after  LE  goes  high. 

Figure  1 1-25  illustrates  the  interfacing  of  the  device  to  a  Z80  microprocessor.  Here  the 
A  side  of  the  PIO  is  used  to  generate  the  Latch  Enable  signal.  The  RDY  line  from  the  PIO 
could  be  used  in  the  mode  where  it  is  tied  to  the  STB  line  to  form  a  pulse  lasting  one 
clock  cycle.  However,  one  clock  cycle  may  not  be  long  enough,  since  the  NE5018  re- 
quires a  400  ns  pulse.  Furthermore,  the  polarity  is  the  opposite  of  that  needed  by  the 
NE5018. 

Note  that  the  PIO  latches  the  output  data.  The  data  therefore  remains  stable  during  and 
after  the  conversion.  The  converter  typically  requires  only  a  few  microseconds  to  pro- 
duce an  analog  output.  Thus,  the  converter  latch  could  be  left  enabled  if  the  port  were 
not  used  for  any  other  purpose. 

In  applications  where  eight  bits  of  resolution  are  not  enough,  10-  to  16-bit  converters 
can  be  used.  Additional  port  logic  is  required  to  pass  all  the  data  bits;  some  converters 
provide  part  of  this  logic. 

The  PIO  here  serves  both  as  a  parallel  data  port  and  as  a  serial  control  port.  Of  course,  if 
Port  A  is  used  for  control,  it  could  actually  handle  up  to  eight  bits. 

Task:  Output  to  converter. 

Purpose:  Send  data  from  memory  location  0040  to  the  converter. 
Flowchart: 


)  Data  =  (0040) 

Send  data 
to  converter 

t 

Pulse 
Latch  Enable 
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Q  MSB 


t    T    T    T    T    ?   T  T' 


Digital 
QND 


Figure  11-24.  Signetics  NE5018  D/A  Converter 


Data  Bus 
from  CPU 


0 


:;> 


NE5018 

D/A 
Converter 


J 


Analog 
Output 


Figure  1 1-25.  Interface  for  an  8-bit  Digital-to-Analog  Converter 


Source  Program: 


LD 

A.IIOOIIIIB 

:MAKE  PORT  A  CONTROL 

OUT 

(PIOCRA),A 

SUB 

A 

;ALL  PORT  A  PINS  OUTPUTS 

OUT 

(PIOCRA),A 

LD 

A.00001111B 

:MAKE  PORT  B  OUTPUT 

OUT 

(PIOCRB),A 

LD 

A,(40H) 

;GET  DATA 

OUT 

(PIODRBl.A 

;SEND  DATA  TO  DAC 

IN 

A.iPIODRA) 

;GET  OLD  CONTROL  DATA 

RES 

4.A 

;BRING  LATCH  ENABLE  LOW 

OUT 

SPIODRAj.A 

SET 

4,A 

;BRING  LATCH  ENABLE  HIGH 

OUT 

(PIODRAi.A 

HALT 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

3E 

LD 

A.1 1001 1 11B 

0001 

CF 

0002 

D3 

OUT 

(PIOCHA),A 

0003 

PIOCRA 

0004 

97 

SUB 

A 

0005 

D3 

OUT 

(PIOCRA), A 

0006 

PIOCRA 

0007 

3E 

LD 

A.OOOOl  1 1 1B 

0008 

OF 

0009 

D3 

OUT 

(PIOCRB), A 

OOOA 

PIOCRB 

OOOB 

3A 

LD 

A,(40H) 

OOOC 

40 

OOOD 

00 

OOOE 

D3 

OUT 

(PIODRB),A 

OOOF 

PIODRB 

0010 

DB 

IN 

A.SPIOuHA) 

0011 

PIODRA 

0012 

CB 

RES 

4,A 

0013 

A7 

0014 

D3 

OUT 

(PIODRA),A 

0015 

PIODRA 

0016 

CB 

SET 

4,A 

0017 

E7 

0018 

D3 

OUT 

(PIODRA),A 

0019 

PIODRA 

001 A 

76 

HALT 

The  particular  bit  that  must  be  set  and  reset  depends,  of  course,  on  how  the  Latch  Ena- 
ble IS  connected  to  the  control  port.  Bit  0  is  often  convenient  to  use  for  control  purposes 
since,  if  that  bit  is  originally  cleared,  it  can  be  set  with  an  INC  instruction  and  reset  with 
a  DEC  instruction. 

We  could  use  the  automatic  brief  strobe  from  B  ACK  if  the  Latch  Enable  were  active- 
high  (and  if  this  strobe  were  long  enough  when  B  ACK  is  tied  back  to  B  STB).  The  pro- 
gram would  then  be: 

:MAKE  PORT  B  OUTPUT 


LD 
OUT 
LD 
OUT 
HALT 


A.OOOOl  11  IB 
(PIOCRB),A 
A,{40H) 
(PIODRB),A 


:GET  DATA 

:SEND  DATA  TO  DAC  AND  ENABLE  LATCH 


An  inverter  gate  could  produce  an  active-low  signal.  Note  how  many  fewer  instructions 
are  necessary. 
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Analog-to-Digltal  Converter 

Purposs:  Fetch  data  from  an  8-bit  analog-to-digital  converter  that  requires  an  Initiate 
Conversion  pulse  to  start  the  conversion  process  and  has  a  Data  Valid  line  to 
indicate  the  completion  of  the  process  and  the  availability  of  valid  data. 

Analog-to-digital  converters  handle  the  continuous  signals  produced  bv  various  types 
of  sensors  and  transducers.^  The  converter  produces  the  digital  input  w/hich  the  com- 
puter requires. 

One  form  of  analog-to-digital  converter  is  the  successive  approximation  device,  which 
makes  a  direct  1-bit  comparison  during  each  clock  cycle.  Such  converters  are  fast  but 
have  little  noise  immunity.  Dual  slope  integrating  converters  are  another  form  of 
analog-to-digital  converter.  These  devices  take  longer  but  are  more  resistant  to  noise. 
Other  techniques,  such  as  the  incremental  charge  balancing  technique,  are  also  used. 

Analog-to-digital  converters  usually  require  some  external  analog  and  digital  circuitry, 
although  complete  units  are  becoming  available  at  low  cost. 

Figure  1 1  -26  shows  the  8-bit  Teledyne  Semiconductor  8703  A/D  converter.  The  device 
contains  a  result  latch  and  tristate  data  outputs.  A  pulse  on  the  Initiate  Conversion  line 
starts  conversion  of  the  analog  Input;  after  about  two  milliseconds  the  result  will  go  to 
the  output  latches,  and  the  Data  Valid  output  will  indicate  this  by  switching  first  low 
and  then  high.  Data  is  read  from  the  latches  by  applying  '0'  to  the  ENABLE  input. 

Figure  1 1  -27  shows  the  interface  for  the  Z80  processor  and  the  8703  converter.^  Port  B 
is  used  to  provide  an  Initiate  Conversion  pulse  (active-high)  of  sufficient  length.  The 
Data  Valid  signal  is  tied  to  A  STB  so  that  Data  Valid  going  low  and  then  high  will  latch 
the  converted  data  into  Port  A.  The  Data  Valid  signal  is  also  tied  to  a  bit  of  Port  B  so  that 
the  CPU  can  determine  its  value.  The  important  edge  on  the  Data  Valid  line  is  the  low- 
to-high  edge,  which  indicates  the  completion  of  the  conversion.  As  in  the  case  of  the 
encoded  keyboard,  additional  circuitry  will  be  necessary  if  the  pulse  on  Data  Valid  is  too 
short  to  be  handled  in  software.  Note  that  we  are  using  Port  B  here  for  both  status  and 
control. 
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Figure  11 -26  Teledyne  8703  A/D  Converter 
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Figure  1 1-27  Interface  for  an  8-bit  Analog-to-Digital  Converter 
Task:  Input  from  converter. 

Purpose:  Start  the  conversion  process,  wait  for  Data  Valid  to  go  low  and  then  high, 
and  then  read  the  data  and  store  it  In  memory  location  0040, 

Flowchart: 


c 


Pulse  Initiate 
Comrarsion 
line 


Read  data  from 
data  input  port 
(0040)  =  Data 


C 


Note  that  here  the  PIO  serves  as  a  parallel  data  port,  a  serial  status  port,  and  a  senal 
control  port. 
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Source  Program: 


LD 

A,01001111B 

:MAKE  PORT  A  INPUT 

OUT 

(PIOCRA),A 

LD 

A.11001111B 

:MAKE  PORT  B  CONTROL 

OUT 

{PIOCRB),A 

LD 

A,00001111B 

;B4-7  OUTPUT,  BO-3  INPUT 

OUT 

(PIOCRBLA 

LD 

A.OOIOOOOOB 

:SEND  INITIATE  CONVERSION  HIGH 

OUT 

(PIODRB),A 

SUB 

A 

;SEND  INITIATE  CONVERSION  LOW 

OUT 

(PIODRB),A 

WTLOW: 

IN 

A,(PIODRBj 

:HAS  DATA  VALID  GONE  LOW? 

BIT 

2,A 

JR 

NZ.WTLOW 

■,N0,  WAIT 

WTHI: 

IN 

A,(PIODRB) 

:IS  DATA  AVAILABLE? 

BIT 

2,A 

JR 

Z,  WTLOW 

:N0,  WAIT 

IN 

A.iPIODRA) 

:YES.  FETCH  DATA  FROM  CONVERTER 

LD 

(40H),A 

:SAVE  CONVERTER  DATA 

HALT 
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Object  Program: 

Memory  Address      Memory  Contents  Instruction 
(Hex)  (Hex)  (Mnemonic) 


0000 

3E 

LD 

A.01001111B 

0001 

4F 

0002 

D3 

OUT 

{PIOCRA),A 

0003 

PIOCRA 

0004 

3E 

LD 

A,11001111B 

0005 

CF 

0006 

D3 

OUT 

(PIOCRB).A 

0007 

PIOCRB 

0008 

3E 

LD 

A.OOOOl  1 1 1B 

0009 

OF 

OOOA 

D3 

OUT 

(PiOCRB).A 

OOOB 

PIOCRB 

OOOC 

3E 

LD 

A.00100000B 

OOOD 

20 

OOOE 

D3 

OUT 

(PIODRBl.A 

OOOF 

PIODRB 

0010 

97 

SUB 

A 

001 1 

D3 

OUT 

(PIODRB),A 

0012 

PIODRB 

0013 

DB 

WTLOW:  IN 

A,  (PIODRB) 

0014 

PIODRB 

0015 

CB 

BIT 

2,A 

0016 

57 

0017 

20 

JR 

NZ.WTLOW 

0018 

FA 

0019 

DB 

WTHI:  IN 

A,(PIODRB) 

001A 

PIODRB 

001 B 

CB 

BIT 

2.A 

001 C 

57 

001 D 

28 

JR 

Z.WTHI 

001 E 

FA 

001 F 

DB 

IN 

A,  (PIODRA) 

0020 

PIODRA 

0021 

32 

LD 

(40H),A 

0022 

40 

0023 

00 

0024 

76 

HALT 

One  approach  to  configuring  PIOs  is  to  use  the  repeated  Block  Output  instruction  OTIR 

and  a  table  m  memory  containing  the  words  to  be  sent  to  the  Control  register.  A  typical 
routine  would  be: 

LD          B.LENG  -.COUNT  =  NUMBER  OF  CONTROL  WORDS 

LD          CPIOCR  ;GET  CONTROL  PORT  NUMBER 

LD          HL.CTLTAB  ;STARTING  ADDRESS  OF  PIO  CONTROL  TABLE 

OTIR  :CONFIGURE  PIO 

In  fact,  another  table  (or  the  Stack)  could  be  used  to  hold  the  number  of  control  words 
and  the  port  number  for  each  PIO. 
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Character  is  ASQl  'E'  with  odd  parrty  {45  hex). 

Remember  that  the  transmission  order  is  Start  bit 
CO'),  bit  0,  bit  1.  bit  2,  bit  3.  bit  4,  bit  6.  bit  6,  Parity 
bit.  Stop  bit  CD,  Stop  bit  Cn 


TTY 

INTERFACE 


STANDARD 
TTY 


Figure  11-28.  Teletypewriter  Data  Format 

A  Teletypewriter  (TTY) 

Purpose;  Transfer  data  to  and  from  a  standard  1 0-charaoter-per- 
seoond  serial  teletypewriter. 

The  common  teletypewriter  transfers  data  in  an  asynchronous 
serial  mode.  The  procedure  is  as  follows: 

1)  The  line  is  normally  in  the  one  state. 

2)  A  Start  bit  Szero  bit)  precedes  each  character. 

3)  The  character  is  usually  7-bit  ASCII  with  the  least  significant 
bit  transmitted  first. 

4)  The  most  significant  bit  is  a  Parity  bit.  which  may  be  even, 
odd,  or  fixed  at  zero  or  one. 

5)  Two  stop  bits  !logic  one)  follow  each  character. 

Figure  11-28  shows  the  format.  Note  that  each  character  requires  the  transmission  of 
eleven  bits,  of  which  only  seven  contain  information.  Since  the  data  rate  is  ten  charac- 
ters per  second,  the  bit  rate  is  10  x  1 1,  or  110  Baud.  Each  bit  therefore  has  a  width  of 
1/110  of  a  second,  or  9.1  milliseconds.  This  width  is  an  average;  the  teletypewriter 
does  not  maintain  it  to  any  high  level  of  accuracy. 

For  a  teletypewriter  to  communicate  properly  with  a  computer,  the  following  pro- 
cedures are  necessary. 


CHARACTER 
FORMAT 


TTY 

RECEIVE 
MODE 


Receive  (flowcharted  m  Figure  11-29): 
Step  1)    Look  for  a  Start  bit  (a  logic  zero)  on  the  data  line. 
Step  2)    Center  the  reception  by  waiting  one-half  bit  time,  or  4.55 
milliseconds. 

Step  3)  Fetch  the  data  bits,  waiting  one  bit  time  before  each  one.  Assemble  the  data 
bits  into  a  word  by  first  shifting  the  bit  to  the  Carry  and  then  circularly  shifting 
the  data  with  the  Carry.  Remember  that  the  least  significant  bit  is  received 
first. 

Step  4)  Generate  the  received  Parity  and  check-  it  against  the  transmitted  Parity.  If 
they  do  not  match,  indicate  a  "Panty  error." 

Step  5)  Fetch  the  Stop  bits  (waiting  one  bit  time  between  inputs).  If  they  are  not  cor- 
rect (if  both  Stop  bits  are  not  one),  indicate  a  "framing  error." 
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^         Start  J 
Gat  input  data 


Count  =  8 
Data    =  0 


Wait  one  bit  time 


Get  mput  data 
Carry  ~  Input  data 
Shift  data  nght 
with  Carrv 


Count  =  Count- 1 


Generate 
received  panty 


.6.-,  IS  panty  == 
received  parity  ?) 


Wait  one  bit  time 


Get  input  data 


Framing 
error 


Count  =  Count  -  1 


Figure  11-29.  Flowchart  for  Receive  Procedure 
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Task  1 :  Read  data. 

Purpose:  Fetch  data  from  a  teletypewriter  through  bit  7  of  a  PIO  data  port  and  place 
the  data  into  memory  location  0060.  For  procedure,  see  Figure  11-29. 

Source  Program: 

(Assume  that  the  serial  port  is  bit  7  of  the  PIO  and  that  no  parity  or  framing  check  is 
necessary) 


LD 

A.UIUU  1 1!  IB 

MAKt  PORT  A  INPUT 

OUT 

(PinCRAI  A 

WTSTB: 

IN 

A,(PIODRA) 

READ  SERIAL  LINE 

RLA 

IS  THERE  A  START  BIT? 

JR 

C.WTSTB 

NO,  WAIT  UNTIL  THERE  IS 

CALL 

DHALF 

YES,  DELAY  HALF  BIT  TIME  TO  CENTER 

LD 

D,  1 0OOOOOOB 

COUNT  WITH  BIT  IN  MSB 

RCVB: 

CALL 

DFULL 

WAIT  1  BIT  TIME 

IN 

A.fPIODRAj 

READ  SERIAL  LINE 

RLA 

MOVE  BIT  TO  CARRY 

RR 

D 

MOVE  BIT  TO  ASSEMBLED  WORD 

JR 

NC.RCVB 

CONTINUE  IF  COUNT  BIT  NOT  IN  CARRY 

LD 

A,D 

LD 

(60H),A 

HALT 

(Delay  program) 

ORG 

30H 

DHALF; 

PUSH 

DE 

SAVE  OLD  REGISTERS 

LD 

D,8 

HALF  BIT  LENGTH  COUNT 

JR 

DLY16 

□FULL: 

PUSH 

DE 

SAVE  OLD  REGISTERS 

LD 

D.16 

FULL  BIT  LENGTH  COUNT 

DLY16: 

LD 

E.8DH 

DELAY  1/16TH  BIT  TIME 

DLY1; 

DEC 

E 

JR 

NZ.DLY1 

DEC 

D 

JR 

NZ,DLY16 

POP 

DE 

RESTORE  OLD  REGISTERS 

RET 

Remember  that  bit  0  of  the  data  is  received  first. 
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Object  Program: 


Memory  Address 

Memorv  Contents 

Instruction 

inex) 

\riexj 

(Mnemonic) 

0000 

3E 

1  n 

A  OlOni  11 1R 

0001 

4F 

0002 

D3 

r^i  IT 

(DIOPDAi  A 

0003 

PIOCRA 

0004 

DB 

WTSTB: 

IM 
UN 

A  (pinnRA) 

0005 

PIODRA 

0006 

17 

0007 

38 

V_>,VV  1  O  !  D 

0008 

FB 

0009 

CD 

CALL 

DHALF 

OOOA 

30 

OOOB 

00 

OOOC 

16 

LD 

D 10000000B 

OOOD 

80 

OOOE 

CD 

RCVB: 

rAI  ( 

OOOF 

35 

0010 

00 

0011 

DB 

ilN 

0012 

PIODRA 

0013 

17 

RLA 

0014 

CB 

RR 

0 

0015 

1A 

0016 

30 

JR 

NC.RCVB 

0017 

F6 

0018 

7A 

LD 

A,D 

0019 

32 

LD 

(60H),A 

001 A 

60 

001 B 

00 

001 C 

76 

HALT 

0030 

D5 

DHALF: 

Pt  tQM 
rUon 

HP 

0031 

16 

i  n 

n  p 
u,o 

0032 

08 

0033 

18 

JR 

DLY16 

0034 

03 

0035 

D5 

□FULL: 

PI  IQM 

rUort 

np 
UC 

0036 

16 

i  n 
LU 

n  1  ft 

U,  1  D 

0037 

10 

0038 

IE 

DLY16: 

LD 

E,8DH 

0039 

8D 

003A 

ID 

DLY1 : 

DEC 

E 

003B 

20 

JR 

NZ.DLYI 

003C 

FD 

003D 

15 

DEC 

D 

003E 

20 

JR 

NZ,DLY16 

003F 

F8 

0040 

D1 

POP 

DE 

0041 

C9 

RET 
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This  program  assumes  that  the  Stack  can  be  used  for  subroutine  calls,  i.e.,  the  monitor 
must  initialize  the  Stack  Pointer.  Otherwise  vou  will  have  to  initialize  the  Stack  Pointer 
as  shown  in  Chapter  10. 


The  constants  for  the  delay  routine  were  calculated  just  as  shown  earlier  in  this  chapter. 
You  might  try  determining  them  for  yourself.  The  delays  do  not  have  to  be  highly  accu- 
rate because  the  reception  is  centered,  the  messages  are  short,  the  bit  rate  is  low,  and 
the  teletypewriter  is  not  highly  accurate  itself 

How  would  you  extend  this  program  to  check  for  the  two  stop  bits?  They  must  both  be 
one  or  a  framing  error  has  occurred. 

You  can  extend  this  program  to  check  odd  parity  by  replacing  the  LD  A.D  instruction 
with  the  sequence: 


SUB 
AND 
JP 


A 
D 

PE,PRERR 


■,IS  PARITY  ODD? 

;N0,  PARITY  ERROR  HAS  OCCURRED 
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Carrv  =  0  (Start  bit) 
Get  output  data 
Shift  data  left 
Circuiariv  with  Carrv 
Count  =  1 1  

=r~ 

Semi  data  to 
Output  Port 

~~r~ 

^ift  data  nght 
circuiariv  with  Carry 
Carry  =  1  (Stop  bit) 
Wait  1  brt  time 

~~r~ 

Count  =  Count  -  1 


Figure  11-30,  Flowchart  for  Transmit  Procedure 
Task  2i  Write  data. 

Purpose:  Transmit  data  to  a  teletypewriter  through  bit  0  of  a  PIO  data  register.  The 
data  Is  in  memory  looatron  0060. 

Transmit  (flowcharted  in  Figure  11-30i 

Step  1)    Transmit  a  Start  bit  (i.e..  a  logic  zero). 
Step  2)    Transmit  the  seven  data  bits,  starting  with  the  least  sig- 
nificant bit. 

Step  3)   Generate  and  transmit  the  Parity  bit. 
Step  4)   Transmit  two  Stop  bits  (i.e.,  logic  ones). 

The  transmission  routine  must  wait  one  bit  time  between  each  operation. 


TTY 

TRANSMIT 
MODE 
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Source  Program:  (Assume  that  parity  need  not  be  generated) 


:  MAKE  PIO  INTO  OUTPUT  PORT 


LD 
OUT 


A.OOOOmiB 
(PIOCRB),A 


:MAKE  PORT  B  OUTPUT 


;  GET  DATA  AND  CLEAR  START  BIT 


LD 

ADD 

LD 


A,(60H) 

A.  A 

B.  11 


GET  DATA 

SHIFT  LEFT  AND  FORM  START  BIT 
COUNT  =  1 1  BITS 


;  TRANSMIT  A  BIT  AND  UPDATE  DATA 
TBIT;       OUT  (PIODRB),A 


OUT 
RRA 
SCF 


;  DELAY  9.1  MS  AND  COUNT  BITS 


CALL 
DJNZ 
HALT 


DFULL 
TBIT 


TRANSMIT  A  BIT 
UPDATE  FOR  NEXT  BIT 
FORM  STOP  BIT  (LOGIC  ONE) 


:  DELAY  9.1  MS 
;COUNT  DOWN  1 1  BITS 


The  DFULL  subroutine  is  the  same  as  before.  Remember  that  bit  0  of  the  data  must  be 
transferred  first. 

Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

3E 

LD 

A,00001111B 

0001 

OF 

0002 

D3 

OUT 

(PIOCRB),A 

0003 

PIOCRB 

0004 

3A 

LD 

A,(60H) 

0005 

60 

0006 

00 

0007 

87 

ADD 

A.A 

0008 

06 

LD 

8.11 

0009 

OB 

OOOA 

D3  TBIT: 

OUT 

(PIODRB),A 

OOOB 

PIODRB 

OOOC 

IF 

RRA 

OOOD 

37 

SCF 

OOOE 

CD 

CALL 

DFULL 

OOOF 

35 

0010 

00 

0011 

10 

DJNZ 

TBIT 

0012 

F7 

0013 

76 

HALT 
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UART 


ADD  A.A  clears  the  least  significant  bit  so  that  it  can  be  used  as  the  start  bit.  The  most 
significant  bit  is  saved  in  the  Carry.  In  actual  applications,  the  startup  routine  should 
place  a  logic  'T  on  the  teletypewriter  line  after  configuration  since  that  line  should  nor- 
mally be  in  the  mark  (one)  state. 

Each  character  consists  of  1 1  bits,  starting  with  a  start  bit  (zero)  and  ending  with  two 
stop  bits  (ones). 

This  program  can  easily  be  extended  to  generate  7-bit  characters  with  odd  parity  in  the 
most  significant  bit  The  parity  generation  routine  (to  be  inserted  after  LD  A,(60H))  is: 

ANA  A  :IS  PARITY  ODD? 

JP  PO,STBIT  :YES,  NO  PROBLEM 

SET  7.A  :N0,  MAKE  IT  ODD  BY  SETTING  MSB 

STBIT:      ADD  A.A  :SHIFT  LEFT  AND  FORM  START  BIT 

How  would  you  generate  even  parity? 

These  procedures  are  sufficiently  common  and  complex  to  merit  a 
special  LSI  device:  the  UART,  or  Universal  Asynchronous 
Receiver/Transmitter. ^0  The  UART  will  perform  the  reception  procedure  and  provide 
the  data  in  parallel  form  and  a  Data  Ready  signal.  It  will  also  accept  data  in  parallel 
form,  perform  the  transmission  procedure,  and  provide  a  Peripheral  Ready  signal  when 
It  can  handle  more  data.  UARTs  may  have  many  other  features,  including: 

1 )  Ability  to  handle  various  bit  lengths  (usually  5  to  8),  parity  options,  and  numbers  of 
Stop  bits  (usually  1.  1-1/2,  and  2). 

2)  Indicators  for  framing  errors,  parity  errors,  and  "overrun  errors"  (failure  to  read  a 
character  before  another  one  is  received). 

3)  RS-232'' compatibility:  i.e.,  a  Request-to-Send  (RTS)  output  signal  that  indicates 
the  presence  of  data  to  communications  equipment  and  a  Clear-to-Send  (CTS)  in- 
put signal  that  indicates,  in  response  to  RTS,  the  readiness  of  the  communications 
equipment.  There  may  be  provisions  for  other  RS-232  signals,  such  as  Received 
Signal  Quality,  Data  Set  Ready,  or  Data  Terminal  Ready. 

4)  Tristate  outputs  and  control  compatibility  with  a  microprocessor. 

5)  Clock  options  that  allow  the  UART  to  sample  incoming  data  several  times  in  order 
to  detect  false  Start  bits  and  other  errors. 

6)  Interrupt  facilities  and  controls. 

UARTs  act  as  four  parallel  ports:  an  input  data  port,  an  output  data  port,  an  input 
status  port,  and  an  output  control  port.  The  status  bits  include  error  indicators  as  well 
as  Ready  flags.  The  control  bits  select  various  options.  UARTs  are  inexpensive  ($5  to 
$50,  depending  on  features)  and  easy  to  use. 
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THE  Z80  SERIAL  INPUT/OUTPUT  DEVICE  (SIO) 

The  Z80  Serial  Input/Output  Device  or  SIO  (see  Figure  11-31)  is  a  complete  com- 
munications contrcrtler  specifically  designed  for  use  in  Z80-based  microcomputers.  It 
can  serve  a  variety  of  communications  functions,  but  we  will  only  discuss  its  use  as  a 
simple  asynchronous  receiver/transmitter.  ^  2 

The  SIO  has  two  complete  channels  !A  and  B)  which  can  both 
receive  and  transmit  serial  data  (see  Figure  11-32).  Channels  that 
can  receive  and  transmit  simultaneously  are  called  full-duplex. 
Alternatives  include  half-duplex  (able  to  transmit  and  receive,  but  not  at  the  same 
time),  receive-only,  and  transmit-only. 

An  SIO  occupies  f^ur  input  port  addresses  and  foui^output  port 
addresses.  The  B/A  (Channel  B  or  A  Select)  and  C/D  (Control  or 
Data  Select)  lipes  choose  one  of  the  four  ports  as  described  in  Ta- 
ble 11-7.  Mos_t  often,  designers  attach  address  bit  Aq  to  the  B/A  input  and  address  bit 
A-|  to  the  C/D  input.  The  SIO  then  occupies  four  consecutive  port  addresses  as  de- 
scribed in  the  last  column  of  Table  11-7. 

As  with  the  PIO,  SIOs  have  more  control  registers  than  ad- 
dresses. In  fact,  each  SIO  has  eight  registers  in  each  chan- 
nel for  control  and  three  registers  for  status.  Figure  1 1-33 
contains  diagrams  of  each  control  or  Write  register:  Figure 
1 1-34  contains  diagrams  of  each  status  or  Read  register.  Two  transfers  are  required  to 
read  or  write  any  of  the  registers  except  Write  Register  0.  The  first  transfer  (written  into 
Write  Register  0)  contains  three  bits  that  direct  the  next  transfer  to  or  from  the  selected 
register.  Note,  in  Figure  11-33,  that  these  three  bits  occupy  the  three  least  significant 
bit  positions  and  that  zeros  in  the  other  bit  positions  indicate  a  bvte  that  has  no  function 
other  than  addressing. 


FULL- 
DUPLEX 


SIO 

ADDRESSES 


ADDRESSING 
SIO  READ  AND 
WRITE  REGISTER 


11-89 


Control  7^ 


Internal 
Control 
Logic 


Interrupt  Control 
Lines 


Discrete 
Control 

and 
Status 


Modem  or 

Other 

Controls 


Figure  11-31.  Block  Diagram  of  the  Z80  SIO 


Table  11-7  SIO  Addresses 


CONTROL  OR 

CHANNEL  B  OR  A 

REGISTER 

PORT  ADDRESS 

DATA  SELECT 

SELECT 

ADDRESSED 

(STARTING  WITH  SIOADD) 

0 

0 

Data  Register  A 

SIOADD 

0 

1 

Data  Register  B 

SIOADD+1 

1 

0 

Control  A 

SIOADD+2 

1 

1 

Control  B 

SIOADD+3 

The  port  addresses  assume  that  C/D  is  tied  to  A-]  and  B/A  to  Aq 
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rxD  TxC 

u 


XMIT 



Shift  arid 

c= 

CRC 
Generator 

Bit  Insert 

SYNC 
Registers 

XMIT 
Buffer 

TV 


TV 


TV 


:> 


CRC 
Checker 


Channel 
Control 

and 
Status 


-  WAIT/RDY 


REC 
FIFO 


REC 
Shift  and 
Bit  Stnp 


n 

RxO  RxC 


SYNC 
Detect 


Figure  11-32.  Block  Diagram  of  SIO  Channel 
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Wrlt«  Rsgistora 

■nw  Z80  SIO  conlains  eight  registers  in  each  channel  that  are  programmed  (written  into)  by  the  s^em  software 
to  configum  the  fijnctfonai  personality  of  each  channel.  All  Write  registers,  with  the  exception  of  Write  Register  0, 
require  two  bytes  to  be  properly  programmed.  The  firet  byte  contains  three  bits  that  point  to  the  sheeted  register 
{D0-D2);  the  second  byte  is  the  actual  control  word  that  is  being  wrftteh  to  that  register  to  configure  the  SIO. 

Write  Register  0  is  a  special  case.  RESET  (either  internal  command  or  external  input)  will  initialize  the  SIO  to  Write 
Register  0.  Alt  basic  commands  (CMD2-CMD0)  and  CRC  controls  (CRCO,  CRC1)  can  be  accessed  with  a  single  byte 
using  Write  Register  0. 

Contained  in  the  first  byte  of  any  Write  register  access  are  the  basic  commands  (CMD2-CMD0)  and  the  CRC  con- 
trols (CRC^.CRCI)  so  that  maximum  system  control  and  flexibility  is  maintained. 

Write  RegiBter  0 


0 

0 

0 

Register  0 

0 

0 

t 

Register  1 

0 

1 

0 

Register  2 

0 

1 

1 

Register  3 

1 

0 

0 

Register  4 

1 

0 

1 

Register  5 

1 

1 

0 

Register  6 

1 

1 

1 

Register  7 

0 

0 

0 

Null  Code 

0 

0 

1 

Send  Abort  (SDLCI 

0 

1 

0 

Reset  External  or  Status  intenupts 

0 

1 

1 

Channel  Reset 

1 

0 

0 

Reset  Rx  Interrupt  on  First  Character 

1 

0 

1 

Reset  Tx  Interrupt  Pending 

1 

1 

0 

Error  Reset 

! 

1 

1 

Return  from  interrupt  (Ch-A  Only) . 

Null  Code 

Reset  Rx  CRC  Checker 

Reset  Tx  CRC  Generator 

Reset  CRC/SYNCS  Sent/Sending  Latch 


Wrtta  Rsglster  1 


i  i  n  i  I 


•  Externa!  Interrupt  Enable 

-  Tx  Interrupt  Enable 

■  Status  Affects  Vector  (Ch-B  Only) 


Rx  Interrupt  Disable 

Rx  Interrupt  on  Rrst  Character  Only  or  Enor 
interrupt  on  All  Rx  Characters  (Parity  Affects  Vector! 
Interrupt  on  All  Rx  Characters  (Parity  Does  Not  Affect  Vector) 

■  WAIT/READY  on  R/T 
•  WAIT  Rg/READY  FN 

■  WAIT/READY  Enable 


Figure  1 1-33.  SIO  Control  or  Write  Registers 


.11-92 


Write  Rsglstar  2 


06 

D5 

04 

D3 

D2 

01 

Writs  Rsglstsr  3 


II  II 


Rx  5  Bits/Character 
Rx  6  Btts/Ctiaracter 
Rx  7  Bits/Character 
Rx  8  Bits/Character 


■  Rx  Enable 

-  SYNC  Character  Load  Inhibit 

-  Address  Search  Mode  (SDLCI 

-  Rx  CRC  Enable 

-  Enter  Hunt  Mode 
"  Auto  Enables 


Writo  Rsgistflr  4 


D7 

06 

05 

04 

03 

02 

01 

-  Panty  Enable  

-  Parity  Even/Odd 


0  0  SYNC  Modes  Enable 

0  1  1  Stop  Bit/Character 

1  0  1-1/2  Stop  Bits/Character 
1  1  2  Stop  Bits/Character 

0  8  Bit  SYNC  Character 

1  16  Bit  SYNC  Character 

0  SDLC  Mode  (01111110  SYNC  Ragi 

1  External  SYNC  Mode 


0  x1  Clock  Mode 

1  x16  Clock  Mode 

0  x32  aock  Mode 

1  x64  Clock  Mode 


Figure  11-33.  SIO  Control    Write  Registers  (Continued) 
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Writs  Raglstsr  6 


06 

DS 

04 

03 

02 

01 

0  0 

0  1 

1  0 

1  1 


Tx  6  Bits  lor  Less)/Character 
Tx  7  Bits/Character 
Tx  6  Bits/Character 
Tx  8  Bits/Character 

-OTR 


-  Tx  CRC  Enable 
-RTS 

•  SDLC/CRC-t6 
-Tx  Enable 
-Send  BREAK 


Write  Rsglster  6 


Also  SOLC  Address  Fml 


Write  Register  7 


For  SOLC  it  must  be  programmed 
to  "01 1 1 1 1 10"  for  nag  Recognition 


Figure  11-33.  SIO  Control  or  Write  Registers  (Continued) 
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Read  Rogistars 

The  Z80  SIO  contains  three  registers  that  can  be  read  to  obtain  the  status  of  each  channel.  Status  information  in- 
cludes error  conditions,  interrupt  vector,  and  standard  communication  interface  protocol  signals.  To  read  the  con- 
tents of  a  selected  Read  register,  the  system  software  must  first  write  out  to  the  SIO  the  byte  containing  pointer 
information  {D0-D2)  in  exactiy  the  same  manner  as  a  Write  register  operation.  Then,  by  issuing  a  READ  operation, 
the  contents  of  the  addressed  Read/Status  register  can  be  read  by  the  Z80  CPU. 

The  real  power  in  this  type  of  command  structure  is  that  the  programmer  has  complete  freedom,  after  pointing  to 
the  selected  register,  of  either  reading  or  writing  to  Initialize  or  test  that  register.  By  designing  software  to  initialize 
the  Z80  SIO  in  a  modular,  structured  fashion,  the  programmer  can  use  the  powerful  Z80  Block  I/O  instructions  to 
significantiv  simplify  and  speed  his  software  development  and  debug. 

Read  Register  0 


■  Rx  Character  Available 

■  interrupt  Pending  (Ch-A  Only) 

-  Tx  Buffer  Empty 

■  DCD 

■  SYNC/HUNT 

■  CTS 

-  Sending  CRC/SYNCS 

■  BREAK/ABORT 


Read  Register  1 


i\    a    il  li 


D6 

D5 

D4 

03 

02 

D1 

DO 

,1  M 


■  An  Sent 


!-Reld  Bits       !-Field  Bits  in 
in  Previous     Second  Previous 
Byte  Bvte 


■  Parity  Enror 
.  Rx  Overrun  Error 
•  CRC/Framing  Error 
-  End  of  Frame  (SDLC) 


Residue  Data  for 
8  Rx  Bits/Character 
R-ogrammed 


Special  Rx 
Condition 
Intentipts 


Figure  11-34.  SIO  Status  or  Read  Registers 
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Read  Register  2  (Channel  B  Only) 


il  II 


DO 


•  V2  I 

.  v3  \  Interrupt 
.  V4  /  Vector 


Figure  11-34.  SIO  Status  or  Read  Registers  (Continued) 
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Note  the  following  special  features  of  the  SIO: 


1) 


4! 


Input  and  output  instructions  address  physically  distinct  SPECIAL 
registers.  There  is  no  way  to  read  the  control  registers  or  write  FEATURES 
into  the  status  registers.  OF  SIO 

All  control  registers  for  a  channel  share  a  single  port  address.  s 
Thus  two  bytes  are  required  to  change  the  contents  of  any  control  register  except 
Register  0. 


RESET  initializes  the  SIO  to  Write  Register  0.  It  also  disables  SIO 
both  receivers  anrd  transmitters,  deactivates  all  control  sig-  RESET 
nals,  and  disables  all  interrupts.  We  will  discuss  the  SIO  inter- 
rupt system  in  Chapter  12. 

The  SIO  must  be  configured  before  it  can  be  used.  The  easiest  way  to  do  this  is  by 
placing  the  required  bytes  into  a  table  and  using  the  repeated  Block  I/O  instruction. 
The  table  must  include  both  the  bytes  needed  to  address  the  various  registers  and 
the  data  that  must  be  placed  into  them.  A  typical  routine  would  be: 


LD 
LD 
LD 
OTIR 


B.LENG 

CSIOCRA 

HLCTLTAB 


NUMBER  OF  WORDS  IN  TABLE 
PORT  NUMBER 
START  OF  CONTROL  TABLE 
CONFIGURE  SIO 


8) 


The  RS-232  signals  are  all  active-low.  However,  the  SIO  control  bits  for  these  sig- 
nals are  active-high  (i.e.,  a  logic  'T  in  a  control  bit  sends  an  RS-232  signal  low). 
The  SIO  requires  an  external  clock.  In  asynchronous  communications  at  110  Baud, 
1 760  Hz  is  usually  supplied  and  the  XI 6  mode  is  used.  The  SIO  will  sample  the  bits 
at  the  clock  frequency  for  synchronization  and  to  avoid  false  start  bits  caused  by 
noise  on  the  line. 

The  Data  Ready  (Rx  Character  Available)  flag  is  bit  0  of  Read  Register  0.  The  Periph- 
eral Ready  (Tx  Buffer  Empty)  flag  is  bit  2  of  Read  Register  0. 
Error  status  bits  (parity,  overrun,  and  framing)  are  in  Read  Register  1. 
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EXAMPLES 


Teletypewriter  I/O  via  a  USART 

Task  1:  Read  from  teletypewriter  through  SIO 

Purpose:  Receive  data  from  a  teletypewriter  through  an  SIO  and  place  the  data  into 
memory  location  0040.  The  data  is  7-bit  ASCII  with  odd  parity. 

Source  Program: 


LD 

-A,4 

:ACCESS  WRITE  REGISTER  4 

OUT 

(SIOCRAl.A 

LD 

A,01 000001 B 

:X16  CLOCK  MODE,  ODD  PARITY 

OUT 

(SIOCRA).A 

LD 

A,3 

lACCESS  WRITE  REGISTER  3 

OUT 

(SIOCRA),A 

LD 

A,01 000001 B 

;7  BIT  CHARACTERS.  ENABLE  RECEIVER 

OUT 

!SIOCRA),A 

SUB 

A 

:ACCESS  READ  REGISTER  0 

OUT 

(SIOCRAiA 

IN 

A,(SIOCRA) 

:,GET  STATUS 

RRA 

:IS  DATA  AVAILABLE? 

JR 

NCWAITD 

:N0,  WAIT 

IN 

A.(SIODRAj 

:YES.  GET  DATA 

LD 

!40H),A 

;SAVE  DATA  IN  MEMORY 

HALT 
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Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

UUUU 

ob 

LD 

A.4 

AAA1 

UUUl 

U4 

UUuz 

Uo 

OUT 

(SIOCRAl.A 

AAAO 

blUOHA 

UUU4 

ot 

LD 

A.0 100000 IB 

0005 

41 

0006 

r\o 
UO 

OUT 

(SIOCRA),A 

0007 

SlUCHA 

0008 

3E 

LD 

A,3 

0009 

03 

OOOA 

D3 

OUT 

(SIOCRAl.A 

OOOB 

SfOCRA 

OOOC 

3E 

LD 

A.01 000001 B 

OOOD 

41 

000 E 

D3 

OUT 

(SIOCRAl.A 

OOOF 

bluCnA 

0010 

y  / 

SUB 

A 

AA1  1 

UO 

OUT 

(SIOCRAl.A 

AA1  O 
UU  i  Z 

otUuHA 

AA1  O 
UU  1  O 

no 
Ud 

WAITD:  IN 

A.(SIOCRA) 

AA 1  A 
UU  14 

olUUnA 

AA  1  C 
UU  1  0 

1  C 

1  r 

RRA 

0016 

30 

JR 

NC.WAITD 

0017 

FB 

0018 

DB 

IN 

A,  (SIODRA) 

0019 

SIODRA 

001 A 

32 

LD 

(40H1.A 

0018 

40 

001 C 

00 

001 D 

76 

HALT 

11-99 


The  program  establishes  Write  Register  4  as  follows: 

Bits  7  and  6  =  01  to  select  XI 6  clock  mode  (1 760  Hz 

must  be  supplied) 

Bit  1  =0  to  select  odd  parity 

Bit  0  =  1  to  enable  parity  checking 
The  program  establishes  Write  Register  3  as  follows: 

Bits  7  and  6=01  for  7  bits  per  character 

Bit  0  =  1  to  enable  the  receiver 
The  received  data  status  bit  is  bit  0  of  Read  Register  0. 
Note  that  any  errors  found  will  be  reported  in  Read  Register  1: 

Bit  6  =  1  for  a  framing  error  (no  stop  biti 

Bit  5  =  1  for  an  overrun  error  (more  data  received  before 
previous  data  read) 

Bit  4  =  1  for  a  parity  error 

Try  adding  an  error  checking  routine  to  the  program.  Set 

(0061)  =  0  if  no  errors  occurred 

=  1  if  a  parity  error  occurred 

=  2  if  an  overrun  error  occurred 

=  3  if  a  framing  error  occurred. 

Note  that  the  receiver  always  checks  for  one  stop  bit. 


EXAMPLE 
OF  SIO 

CONFIQURATION 


SIO 

ERROR 

STATUS 
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Task  2:  Write  to  teletype  through  SIO. 

Purpose:  Send  data  from  memory  location  0040  to  a  teletypewriter  through  an  SIO. 
The  data  is  7-bit  ASCII  with  odd  parity. 

Source  Program: 


1  n 

A  A 

■APPPQC;  \A/RITP  RFniQTFR  A 

.HtKjKjC.oo  vvni  i  c  nCuio  1  cn  f 

Cil  IT 

1  n 

M.U  1  UU  1  i  U  1  D 

■Y1R  PI  npk'  N/innp  o  ctdp  ritc  nnn  daritv 

, A  1  D  ULUUIx  fVIUUt,  Z.  o  1  Ur  Dt  1  o.  UUU  rMnl !  T 

ni  IT 

1  n 

A  p; 

■APPPQQ  \A/RiTP  RPriKTPR  R 

OUT 

(SIOCRA),A 

LD 

A.OOIOIOOOB 

;7  BIT  CHARACTERS,  ENABLE  TRANSMITTER 

OUT 

(SIOCRA),A 

SUB 

A 

■.ACCESS  READ  REGISTER  0 

OUT 

(SIOCRAl.A 

IN 

A.(SIOCRAj 

;GET  STATUS 

BIT 

2.A 

;IS  TRANSMITTER  READY? 

JR 

Z.WAITR 

:N0,  WAIT 

LD 

A,!40H) 

:YES.  GET  DATA 

OUT 

(SIODRA),A 

:AND  TRANSMIT  IT 

HALT 
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Object  Program: 


Memorv  Address 

Memorv  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

0000 

3E 

LU 

A  A 

0001 

04 

0002 

D3 

Hi  IT 

0003 

SIOCRA 

0004 

3E 

A  mnni  1  ni  r 

h\,\i  1  \J\i  [  1  U  i  D 

0005 

4D 

0006 

D3 

OUT 

(ciorRA)  A 

0007 

SIOCRA 

0008 

3E 

LD 

A,  5 

0009 

05 

OOOA 

D3 

Hi  IT 

/cinrRAi  A 

OOOB 

SIOCRA 

OOOC 

3E 

LU 

A,UU  1 U  I  UUUd 

OOOD 

28 

OOOE 

D3 

r\\  IT 
UU  1 

OOOF 

SIOCRA 

0010 

97 

SUB 

A 

0011 

D3 

UU  1 

lbiUCnA),A 

0012 

SIOCRA 

0013 

DB 

VVAi  in.  iN 

A    (C lO/^ D  A  \ 

A.lbiUCnAi 

0014 

SIOCRA 

0015 

CB 

BIT 

2,  A 

0016 

57 

AA  1  ~t 
UU  1  / 

lo 

JR 

Z.WAiTR 

0018 

FA 

0019 

3A 

LD 

A,{40H) 

001 A 

40 

0018 

00 

001 C 

D3 

OUT 

(SIODRAI.A 

001 D 

SIODRA 

001E 

76 

HALT 

The  program  establishes  Write  Register  4  as  follows: 


Bits  7  and  6  =  01  to  select  XI 6  clock  mode  (1760  Hz  must  be  supplied! 

Bits  3  and  2  =  11  to  add  2  stop  bits  to  each  character 

Bit  1  =0  to  select  odd  parity 

Bit  0  =  1  to  enable  parity  generation 
The  program  establishes  Write  Register  5  as  follows: 

Bits  6  and  5=01  for  7  bits  per  character 

Bit  3  =  1  to  enable  the  transmitter 
The  transmitter  status  bit  Is  bit  2  of  Read  Register  1. 
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STANDARD  INTERFACES 

Other  standard  interfaces  besides  the  TTY  current-loop  and  STANDARD 
RS-232  can  also  be  used  to  connect  peripherals  to  the  microcom-  INTERFACES 
puter.  Popular  ones  include: 

1)  The  serial  RS449,  RS422,  and  RS423  interfaces.  13 

2)  The  8-bit  parallel  General  Purpose  Interface  Bus,  also  known  as  IEEE-488  or 
Hewlett-Packard  Interface  Bus  (HPIB).14 

3)  The  S-100  or  Altair/lmsai  hobbyist  bus.  15  Jhis  is  also  an  8-bit  bus. 

4)  The  Intel  Multibus.16  This  is  another  8-bit  bus  that  can,  however,  be  expanded  to 
handle  16  bits  in  parallel. 

PROBLEMS 

6)  Separating  Closures  from  an  Unencoded  Keyboard 

Purpose:  The  program  should  read  entries  from  an  unencoded  3x3  keyboard  and 
place  them  into  an  array.  The  number  of  entnes  required  is  in  memory  loca- 
tion 0040  and  the  array  starts  in  memory  location  0041. 

Separate  one  closure  from  the  next  by  waiting  for  the  current  closure  to  end.  Remember 
to  debounce  the  keyboard  (this  can  be  simply  a  1  ms  wait). 

Sample  Problem: 

(0040)   =  04 
Entries  are  7,  2.  2,  4 
Result:   (0041)   =  07 

(0042)  =  02 

(0043)  =  02 

(0044)  =  04 

7)  Read  a  Sentence  from  an  Encoded  Keyboard 

Purpose:  The  program  should  read  entries  from  an  ASCII  keyboard  (7  bits  with  a  zero 
Parity  bit)  and  place  them  into  an  array  until  it  receives  an  ASCII  period  (hex 
2E).  The  array  starts  in  memory  location  0040.  Each  entry  is  marked  by  a 
strobe  as  in  the  example  given  under  An  Encoded  Keyboard, 

Sample  Problem: 


Entries 

are 

H,  E 

L,  L,  0, 

Result:  (0040) 

48 

H 

(0041) 

45 

E 

(0042) 

4C 

L 

(0043) 

40 

L 

(0044) 

4F 

0 

(0045) 

2E 
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8)   A  Variable  Amplitude  Square  Wave  Generator 

Purpose:  The  program  should  generate  a  square  wave,  as  shown  m  the  next  figure, 
using  a  D/A  converter.  Memory  location  0040  contains  the  scaled  amplitude 
of  the  wave,  memory  location  0041  the  length  of  a  half  cycle  in  milliseconds, 
and  memory  location  0042  the  number  of  cycles. 

Assume  that  a  digital  output  of  80-]  g  to  the  converter  results  in  an  analog  output  of  zero 
volts.  In  general,  a  digital  output  of  D  results  in  an  analog  output  of  Vqut  =  ~"Vref 
(D-80)/80  volts. 
Sample  Problem: 

(0040)  =  AO  (hex) 

(0041)  =  04 

(0042)  =  03 


Result: 


+  VREF  I 

->Vref  j 

Output  4 


Voltage 


0  H- 

^REFI— 


I 


The  base  voltage  is  80-]  g  =0  volts. 
Full  scale  is  lOOig  =  -Vr^p  volts. 
So  -A0i6  =  (A0-80)/80  X  -Vref  =  "VreF'''* 
The  program  produces  3  pulses  of  amplitude  VrffM  with  a  half  cycle  length  of  4  ms. 

9)  Averaging  Analog  Readings 

Purpose:  The  program  should  take  four  readings  from  an  A/D  converter  ten  millise- 
conds apart  and  place  the  average  in  memory  location  0040.  Assume  that 
the  A/D  conversion  time  can  be  ignored. 

Sample  Problem: 

Readings  are  (hex)  86,  89,  81,  84 
Result:    (0040)  =  85 

10)  A  30  Character-per-Second  Terminal 

Purpose:  Modifv  the  transmit  and  receive  routines  of  the  example  given  under  A 
Teletypewriter  to  handle  a  30  ops  terminal  that  transfers  ASCII  data  with  one 
stop  bit  and  even  parity.  How  could  you  write  the  routines  to  handle  either 
terminal  depending  on  a  flag  bit  in  memory  location  0060:  e.g..  (0060)  =  0 
for  the  30  cps  terminal.  (0060)  =  1  for  the  10  cps  terminal? 
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Chapter  1 2 
INTERRUPTS 


Interrupts  are  inputs  that  the  CPU  examines  as  part  of  each  instruction  cycle.  These  in- 
puts allow  the  CPU  to  react  to  asynchronous  events  in  a  more  efficient  manner  than 
polling  each  device.  When  interrupts  are  utilized  to  initiate  I/O,  generally  more  hard- 
ware than  ordinary,  programmed  I/O  is  required,  but  this  provides  a  faster  and  more 
direct  response.^ 

Why  use  interrupts?  Interrupts  allow  events  such  as  alarms,  power  REASONING 
failure,  the  passage  of  a  certain  amount  of  time,  and  peripherals  BEHIND 
having  data  or  being  ready  to  accept  data  to  get  the  immediate  at-  INTERRUPTS 
tention  of  the  CPU.  The  programmer  does  not  need  to  poll  every  1— — — — — I 
device,  nor  need  the  programmer  worry  about  the  system  completely  missing  events. 
An  interrupt  system  is  like  the  bell  on  a  telephone  —  it  rings  when  a  call  is  received  so 
that  you  don't  have  to  pick  up  the  receiver  occasionally  to  see  if  someone  is  on  the  line. 
The  CPU  can  go  about  its  normal  business  (and  get  a  lot  more  done).  When  something 
happens,  the  interrupt  rouses  the  CPU  and  forces  it  to  service  the  input  before  resuming 
normal  operations.  Of  course,  this  simple  description  becomes  more  complicated  (just 
like  a  telephone  switchboard)  when  there  are  many  interrupts  of  varying  importance 
and  there  are  tasks  that  cannot  be  interrupted. 

The  implementation  of  interrupt  systems  varies  greatly. 
Among  the  questions  that  must  be  answered  to  character- 
ize a  particular  system  are: 

1)  How  many  interrupt  inputs  are  there? 

2)  How  does  the  CPU  respond  to  an  Interrupt? 

3)  How  does  the  CPU  determine  the  source  of  an  interrupt  if  the  number  of  sources 
exceeds  the  number  of  inputs? 

4)  Can  the  CPU  differentiate  between  important  and  unimportant  interrupts? 

5)  How  and  when  is  the  interrupt  system  enabled  and  disabled? 

There  are  many  different  answers  to  these  questions.  The  aim  of  ail  the  implementa- 
tions, however,  is  to  have  the  CPU  respond  rapidly  to  interrupts  and  resume  normal  ac- 
tivity afterwards. 

The  number  of  interrupt  inputs  on  the  CPU  chip  determines  the  number  of  different 
responses  that  the  CPU  can  produce  without  any  additional  hardware  or  software.  Each 
input  can  produce  a  different  internal  response.  Unfortunately,  most  microprocessors 
have  a  very  small  number  (one  or  two,  typicallv)  of  separate  interrupt  inputs. 

The  ultimate  response  of  the  CPU  to  an  interrupt  must  be  to  transfer  control  to  the  cor- 
rect interrupt  service  routine  and  to  save  the  current  value  of  the  Program  Counter.  The 
CPU  must  therefore  execute  a  Jump-to-Subroutine  or  Call  instruction  with  the  begin- 
ning of  the  interrupt  service  routine  as  its  address.  This  action  will  save  the  return  ad- 
dress in  the  Stack  and  transfer  control  to  the  interrupt  service  routine.  The  amount  of 
external  hardware  required  to  produce  this  response  varies  greatly.  Some  CPUs  inter- 
nally generate  the  instruction  and  the  address:  others  require  external  hardware  to 
form  them.  The  CPU  can  only  generate  a  different  instruction  or  address  for  each  sepa- 
rate input. 


CHARACTERISTICS 
OF  INTERRUPT 
SYSTEMS 
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VECTORING 


If  the  number  of  interrupting  devices  exceeds  the  number  of  in-  POLLING 
puts,  the  CPU  will  need  extra  hardware  or  software  to  identify  the 
source  of  the  interrupt.  In  the  simplest  case,  the  software  can  be  a 
polling  routine  which  checks  the  status  of  the  devices  that  may  be 
interrupting.  The  only  advantage  of  such  a  system  over  normal  polling  is  that  the  CPU 
knows  that  at  least  one  device  is  active.  The  alternative  solution  is  for  additional  hard- 
ware to  provide  a  unique  data  input  (or  "vector")  for  each  source.  The  two  alternatives 
can  be  mixed;  the  vectors  can  identify  groups  of  inputs  from  which  the  CPU  can  iden- 
tify a  particular  one  by  polling. 

An  interrupt  system  that  can  differentiate  between  important  and  |  PRIORITY 

unimportant  interrupts  is  called  a  "priority  interrupt  system."  In- 
ternal hardware  can  provide  as  many  priority  levels  as  there  are  inputs.  External  hard- 
ware can  provide  additional  levels  through  the  use  of  a  Priority  register  and  comparator. 
The  external  hardware  does  not  allow  the  interrupt  to  reach  the  CPU  unless  its  priority 
IS  higher  than  the  contents  of  the  Prionty  register.  A  priority  interrupt  system  may  need 
a  special  way  to  handle  low-priority  interrupts  that  may  be  ignored  for  long  periods  of 
time. 


ENABLING 
AND 

DISABLING 
INTERRUPTS 


Most  interrupt  systems  can  be  enabled  or  disabled.  In  fact,  most 
CPUs  automatically  disable  interrupts  when  a  RESET  is  performed 
(so  that  the  programmer  can  configure  the  interrupt  system)  and 
on  accepting  an  interrupt  (so  that  the  interrupt  will  not  interrupt 
its  own  service  routine).  The  programmer  may  wish  to  disable  in- 
terrupts while  preparing  or  processing  data,  performing  a  timing  loop,  or  executing  a 
multi-byte  operation. 

An  interrupt  that  cannot  be  disabled  (sometimes  called  a  "non- 
maskable interrupt"!  may  be  useful  to  warn  of  power  failure,  an 
event  that  obviously  must  take  precedence  over  all  other  ac- 
tivities. 

The  advantages  of  interrupts  are  obvious,  but  there  are  also 
disadvantages.  These  include: 


NON-MASKABLE 
INTERRUPT 


DISADVANTAGES 
OF  INTERRUPTS 


1) 


2) 


Interrupt  systems  may  require  a  large  amount  of  extra 
hardware. 


nterrupts  still  require  data  transfers  under  program  control  through  the  CPU.  There 
IS  no  speed  advantage  as  there  is  with  DMA. 

3)  Interrupts  are  random  inputs,  which  makes  debugging  and  testing  difficult.  Errors 
may  occur  sporadically,  and  therefore  may  be  very  hard  to  find.^ 

4)  Interrupts  may  involve  a  large  amount  of  overhead  if  many  registers  must  be  saved 
and  the  source  must  be  determined  by  polling. 

Z80  INTERRUPT  SYSTEM 

The  ZSO's  internal  response  to  an  interrupt  is  fairly  complex,  since  there  are  three 
different  operating  modes.  The  interrupt  system  consists  of; 

1)  An  active-low  maskable  interrupt  input  (INT)  and  an  active- 
low  non-maskable  interrupt  input  (NMI). 

2)  Two  enable  flip-flops  (IFF1  and  IFF2).  IFF1  can  be  set  or  reset 
to  enable  or  disable  interrupts.  IFF2  serves  as  temporary 
storage  for  IFF1  during  non-maskable  interrupts. 


Z80 

INTERRUPT 
INPUTS 
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Z80 

INTERRUPT 
RESPONSE 


Z80  INTERRUPT 
INSTRUCTION 


The  Z80  checks  the  current  status  of  the  interrupt  system  at  the 
end  of  each  instruction  cycle.  If  an  interrupt  is  active  and  enabled, 
the  response  is  as  follows:^ 

1)  The  CPU  disables  the  interrupt  system  by  clearing  IFFl.  IFF2, 

howeyer,  is  left  in  its  original  state  If  a  non-maskable  Interrupt  has  occurred.  Note 
that  RESET  clears  both  interrupt  flip-flops  so  that  the  system  can  be  configured 
before  interrupts  are  enabled. 

2)  The  CPU  executes  a  special  Interrupt  Acknowledge  cycle,  distinguished  by  the  MT 
signal  (operation  code  fetchl  being  active,  MREQ  (memory  request)  inactive  (so  the 
CPU  will  not  perform  its  normal  memory  access),  and  lORQ  (input/output  request) 
active  so  that  an  interrupt  response  vector  can  be  placed  on  the  Data  Bus. 

The  remainder  of  the  response  depends  on  the  interrupt  mode  and  the  source. 

Note  in  particular  that  the  Z80  will  check  for  interrupts  after  each  transfer  or  com- 
parison in  a  Block  Move,  Block  Compare,  or  Repeated  Block  I/O  instruction. 

The  Z80  has  the  following  special  instructions  for  use  with  the 
interrupt  system: 

1)  El  (Enable  Interrupts)  enables  the  maskable  interrupt  by 
setting  the  interrupt  flip-flops. 

2)  Dl  (Disable  interrupts)  disables  the  maskable  Interrupt  by  cleanng  the  interrupt  flip- 
flops. 

3)  RST  (Restart)  is  a  one-word  Call  instruction  that  saves  the  current  value  of  the  Pro- 
gram Counter  in  the  Stack  and  jumps  to  the  address  specified  m  the  instruction. 
Table  12-1  contains  the  various  Restart  instructions  and  their  destination  ad- 
dresses. RST  is  often  used  in  interrupt  systems  because  it  is  a  one-word  instruction 
that  is  easy  to  form  and  place  on  the  Data  Bus. 

4)  RETI  (Return  from  Interrupt)  acts  exactly  like  a  normal  Return  (RET)  instruction  ex- 
cept that  Z80  penpheral  chips  (PIOs.  SIOs,  and  CTCs)  recognize  this  instruction  and 
use  it  as  a  notification  that  the  current  interrupt  service  routine  has  been  com- 
pleted. 

5)  RETN  (Return  from  Non-Maskable  Interrupt)  acts  exactly  like  a  normal  Return  (RET) 
instruction  except  that  it  loads  IFFl  from  IFF2  so  as  to  restore  the  original  state  of 
the  interrupt  system. 

6)  LD  A.I  loads  the  Accumulator  with  the  contents  of  the  I  (Interrupt  Vector)  register. 
This  instruction  (and  LD  A.R)  also  places  IFF2  into  the  P/0  bit  of  the  Flag  register. 
That  flag  can  then  be  tested  or  saved  in  the  Stack. 

7)  LD  I.A  loads  the  I  (Interrupt  Vector)  register  with  the  contents  of  the  Accumulator. 

8)  IM  (Set  Interrupt  Mode)  determines  the  mode  In  which  interrupts  are  serviced.  The 
three  options  are  0.  1.  or  2:  these  are  described  later  in  this  chapter. 

Non-Maskable  Interrupt 


The  non-maskable  interrupt  is  an  edge-sensitive  (negative  Z80 
edge  triggered)  input.  The  processor  therefore  reacts  only  to  NON-MASKABLE 
the  edge  of  a  pulse  on  this  line,  and  the  pulse  will  not  interrupt  INTERRUPT 
its  own  service  routine.  Non-maskable  interrupts  are  useful  for 
applications  that  must  respond  to  loss  of  power  (i.e.,  must  save  data  in  a  low-power 
memory  or  switch  to  a  backup  battery).  Typical  applications  are  communications  equip- 
ment that  must  retain  codes  and  partial  messages  and  test  equipment  that  must  keep 
track  of  partially  completed  tests. 
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Table  12-1  The  Restart  (RST)  Instructions 


RST  Instruction 

Operation  Code 

Destination  Address 

{Mnemonic} 

Hex) 

(Hex) 

RSTO 

C7 

0000 

0 

RST  8 

CF 

0008 

08 

RST  lOH 

D7 

0010 

IS 

RST  t8H 

DF 

0018 

24 

RST  20H 

E7 

0020 

32 

RST  28H 

EF 

0028 

40 

RST  30H 

F7 

0030 

48 

RST  38H 

FF 

0038 

56 

The  Z80  responds  to  a  non-maskable  Interrupt  as  follows: 

1)  It  clears  IFF1.  thus  disabling  all  interrupts  (but  saving  the  old  state  of  IFF1  in  IFF2). 

2)  It  ignores  the  next  instruction  fetched  from  memory  and  instead  jumps  to  memon/ 
location  0066-1  g,  saving  the  old  value  of  the  Program  Counter  in  the  Stack. 

Remember  that  a  RETN  instruction  at  the  end  of  the  service  routine  will  restore  the  old 
state  of  IFF1  from  IFF2. 

We  will  not  discuss  the  non-maskable  interrupt  further.  Henceforth,  we  will  assume 
that  all  interrupt  inputs  are  tied  to  INT. 

Z80  Interrupt  Modes  ________ 

The  Z80  has  three  interrupt  modes.  The  programmer  can  choose  INTERRUPT  I 
any  of  these  modes  with  the  appropriate  IM  instruction.  On  reset,  MOPES  | 
the  processor  always  enters  Mode  0.  The  modes  are: 

Mode  0 

In  this  mode,  the  CPU  uses  the  data  input  during  the  Interrupt  .Acknowledge  cycle  as  an 
instruction.  This  mode  is  the  same  as  the  8080  interrupt  response  mode.^ 

The  normal  data  input  that  must  be  provided  externally  is  a  RST  instruction  (see  Table 
12-1). 

RST  is  useful  in  interrupt  systems  for  the  following  reasons: 

1)  It  IS  a  one-word  instruction  and  so  requires  only  one  fetch 
cycle. 

2)  It  provides  eight  different  destination  addresses  or  vectors. 

3)  Its  vectors  are  far  enough  apart  to  allow  Jump  instructions  to  reach  the  actual  ser- 
vice routines. 

4)  It  is  easy  to  form,  since  five  of  the  bits  are  always  '1.'  An  8-to-3  encoder  can  provide 
the  other  three  bits  quite  easily. 

RST  has  the  following  disadvantages: 

1)  It  cannot  provide  more  than  eight  vectors. 

2)  Its  vectors  are  not  far  enough  apart  to  allow  space  for  entire  interrupt  service 
routines. 

3)  Its  vectors  are  in  a  fixed  area  of  memory. 

4)  RST  0  has  the  same  destination  address  as  the  RESET  input  and  is  therefore  very 
difficult  to  use.  The  system  needs  hardware  to  differentiate  between  RESET  and 
RST  0,  since  the  two  cannot  be  distinguished  by  software  alone. 


RESTART 
INSTRUCTION 
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Remember  that  RST  saves  the  old  Program  Counter  in  the  Stack  just  as  CALL  does. 
Mode  1 

In  this  mode,  the  CPU  ignores  the  data  Input  during  the  Interrupt  Acknowledge  cycle 
and  always  executes  RST  38H,  thus  jumping  to  memory  location  0038ig  and  saving 
the  old  Program  Counter  in  the  Stack.  This  mode  is  equivalent  to  Mode  0  if  the  data  in- 
put IS  always  RST  38H  {FF]q). 

The  advantage  of  this  mode  is  that  no  external  hardware  is  required.  Its  disadvantages 
are  that  there  is  no  way  to  directly  differentiate  among  interrupt  sources  and  the 
destination  address  is  fixed.  Mode  1  is  useful  in  applications  that  have  only  one  or  two 
interrupt  sources  and  in  which  minimum  hardware  cost  is  essential. 

Mode  2 

In  this  mode,  the  CPU  uses  the  data  input  as  part  of  an  address  from  which  to  get  the 
starting  address  of  the  interrupt  service  routine.  When  an  interrupt  is  accepted,  the 
CPU: 

1)  Disables  further  interrupts  by  clearing  IFF1  and  IFF2. 

2)  Stores  the  old  Program  Counter  in  the  RAM  Stack. 

3)  Forms  a  pointer  from  the  contents  of  Register  I  (eight  MSBs)  and  the  Data  Bus  input 
during  the  interrupt  Acknowledge  cycle  (eight  LSBs).  The  least  significant  bit  of 
this  pointer  is  forced  to  zero. 

41    Fetches  an  address  from  the  two  memory  locations  starting  with  the  one  referred  to 

by  the  pointer  (see  Figure  12-1). 
5)    Transfers  control  to  the  address  obtained  from  memory. 
Interrupt  response  in  this  mode  requires  19  clock  cycles. 

The  advantage  of  this  mode  is  that  it  can  provide  a  full  page  of  128  interrupt  service 
vectors  located  anywhere  in  memory.  The  disadvantages  of  this  approach  are  that  the 
interrupt  response  is  slower  and  the  system  must  be  initialized,  as  follows: 

1)   The  table  of  vectors  must  be  loaded  into  memory  if  it  is  not  m  ROM. 

21    The  I  register  must  be  loaded  with  the  eight  most  significant  bits  (or  page  number) 

of  the  table  address.  Note  that  RESET  clears  Register  I.  You  can  load  I  with  a  value 

as  follows: 

LD  A,IPGNO       ;GET  INTERRUPT  PAGE  NUMBER 

LD  I, A  :  STORE  IN  VECTOR  REGISTER 

3)    Interrupt  Mode  2  must  be  set  with  the  instruction  IM  2. 

Mode  2  is  designed  to  work  with  Z80  PIOs,  SIOs,  and  CTCs.  PIO  and  SIO  interrupts  are 
described  later  in  this  chapter. 

Z80/8080  INTERRUPT  COMPATIBILITY 

Mode  0  for  the  Z80  interrupt  system  is,  as  mentioned,  identical  to  the  8080  interrupt 
response.  The  8080  does  not  have  Interrupt  Modes  1  or  2.  although  Mode  1  is  really  just 
a  special  case  of  Mode  0.  The  8080  also  has  no  NMI  input. 

The  8085  has  additional  interrupt  inputs,  not  available  on  either  the  8080  or  the  Z80. 
The  8085  also  has  a  non-maskable  interrupt  (called  TRAP)  that  forces  a  call  to  a 
different  address  (24-\q}  than  that  used  by  the  Z8D  NMI  input. 
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desired  starting  address 
pointed  to  by: 


8  Bits  from 

7  bits  from 

1  Register 

Penpheral 

0 

high-order 


Interrupt 

Service 

Routine 

Starting 

Address 

Table 


Figure  12-1.  Forming  an  Interrupt  Vector  in  Interrupt  Mode  2 


PIG 

INTERRUPTS 


PIO  INTERRUPTS 

Most  Z80  interrupt  systems  involve  PIOs.  Each  port  of  the  PIO  has 
the  following  features  for  use  with  interrupts: 

1)  An  8-bit  Interrupt  Vector  register  used  to  hold  the  eight  least 
significant  bits  of  the  table  address  formed  by  the  CPU  in  Interrupt  Mode  2. 

2)  An  interrupt  enable  bit. 

3)  An  Interrupt  Control  register  used  to  determine  the  logical  operation  performed  and 
the  active  polarity  monitored  for  generating  interrupts  in  the  control  mode. 

4)  An  Interrupt  Mask  register  used  to  determine  which  data  lines  will  be  monitored  to 
generate  interrupts  in  the  control  mode. 

The  interrupt  Vector  register  in  each  port  can  be  accessed  by  writ-  PIO 

ing  a  control  word  with  a  zero  in  its  least  significant  bit.  as  shown  INTERRUPT 

below  (see  also  Table  11-2):  VECTOR 


D7 

D6 

D5 

04 

D3 

02 

Dl 

DO 

|v, 

V6 

V5 

y4 

V2 

V1 

/I 

signifies  this  control  word  is  an  / 
iniemjpt  vector 

A  typical  sequence  to  establish  the  value  m  this  register  is: 

LD  A.IVECT 
OUT  (PIOCR),A 

where  IVECT  has  a  '0'  in  its  least  significant  bit.  The  starting  address  for  the  interrupt 
service  routine  is  at  address  IVECT  on  the  page  assigned  to  the  table  of  starting  ad- 
dresses for  service  routines. 
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D7 

D6 

05 

D4 

D3 

D2 

01 

DO 

Enable 
interrupt 

AND/ 
OR 

High/ 
Low 

(Vleslt 
foiiows 

0 

1 

1 

t 

used 

in  Mode  3  only 

signifies  interrupt  controi  word 

Figure  12-2.  Format  for  a  PIO  Interrupt  Control  Word 


07  D6  05  D4  03  D2  D1  00 


MB7 

IV1B6 

MBS 

MB4 

IV1B3 

MB2 

MBl 

IVIBO 

Oniy  those  port  iines  whose  masl<  bit  is  zero  will  be  monitored  for  generating  an  interrupt. 


Figure  12-3.  Format  for  a  PIO  Interrupt  Mask 

We  can  set  the  interrupt  control  word  in  eacfi  port  by  writing  a 
control  word  with  the  format  shown  m  Figure  1 2-2.  If  the  port  is  m 
Mode  3,  bits  D6,  D5,  and  D4  have  the  following  meanings: 

1)  D6  =  1  means  that  all  monitored  I/O  lines  must  become  active 
to  cause  an  interrupt  (i.e..  a  logical  AND),  while  D6  =  0  means 
that  any  monitored  I/O  line  becoming  active  will  cause  an  interrupt  (i-e..  a  logical 

'  OR). 

Note  that  an  interrupt  occurs  only  if  the  logical  equation  is  true  when  interrupts  are 
enabled  or  if  it  changes  from  false  to  true  while  interrupts  are  enabled. 

2)  D5  defines  the  active  polarity  (high  or  low)  of  the  monitored  I/O  lines.  D5  =  1 
means  active  high.  D5  =  0  means  active  low. 

3)  D4  =  1  means  that  the  next  control  word  is  an  interrupt  mask  (Figure  12-3).  Only 
lines  With  a  mask  bit  of  zero  will  be  monitored.  D4  =  0  means  that  the  mask  does 
not  follow. 

Bit  7  of  the  interrupt  control  word  determines  the  value  of  the 
interrupt  enable  flip-flop  for  the  port.  Interrupts  may  be  gener- 
ated if  the  flip-flop  is  set.  Power-on  resets  this  flip-flop,  but 
remember  that  the  PIO  has  no  RESET  input.  The  interrupt  ena- 
ble flip-flop  may  be  set  or  reset  without  affecting  the  rest  of  the  interrupt  control  word 
by  writing  a  control  word  with  the  flip-flop  value  in  bit  7  and  001 1  in  the  four  least  sig- 
nificant bits. 

Setting  bit  4  of  the  interrupt  control  word  clears  any  pending  interrupts.  This  can  be 
used  to  clear  interrupts  that  may  have  occurred  inadvertently  during  a  reset. 


PIO 

INTERRUPT 

CONTROL 

MODE 


ENABLING  AND 
DISABLING  PIO 
INTERRUPTS 
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Examples 

1)    Interrupting  output  port  with  vector  located  at  address 
80ig.  Remennber  that  the  page  number  is  in  the  CPU  I 


register. 

LD 

A.oooomiB 

OUT 

(PIOCRB).A 

LD 

A.80H 

OUT 

(PIOCRAl.A 

LD 

A,  1000001  IB 

OUT 

(PIOCRBI.A 

EXAMPLES  OF 
PIO  INTERRUPT 
CONFIGURATION 


;MAKE  PORT  B  OUTPUT 
;VECTOR  ADDRESS  =80  HEX 
;ENABLE  PIO  INTERRUPT 


An  alternative  that  clears  pending  interrupts  as  well  as  enabling  interrupts  from  the 
port  is: 

LD  A.10010111B     :ENABLE  PIO  INTERRUPT 

OUT  (PIOCRA),A 

An  interrupt  will  occur  on  the  rising  edge  of  STB. 

Interrupting  input  port  with  vector  located  at  address  60ig. 


LD 

OUT 

LD 

OUT 

LD 

OUT 


A.OIOOmiB 

(PIOCRA),A 

A.60H 

(PIOCRAl.A 

A.  1000001  IB 

(PIOCRAl.A 


iMAKE  PORT  A  INPUT 
:VECTOR  ADDRESS  =  60  HEX 
;ENABLE  PIO  INTERRUPT 


An  interrupt  will  occur  on  the  rising  edge  of  STB. 

Interrupting  control  port  with  vector  located  at  address  48-|5.  An  interrupt  will,  be 
generated  if  data  lines  A4  and  A7  both  go  low. 


LD 

A.IIOOmiB 

:MAKE  PORT  A  CONTROL 

OUT 

{PIOCRAl.A 

LD 

.A,10001000B 

.-LINES  4.7  INPUTS  -  OTHERS  OUTPUTS 

OUT 

(PIOCRAl.A 

LD 

A.48H 

:VECTOR  ADDRESS  =  48  HEX 

OUT 

(PIOCRAl.A 

LD 

A.11010111B 

:ENABLE  PIO  INTERRUPT 

OUT 

(PIOCRAl.A 

LD 

A.01110111B 

:MONITOR  LINES  4.7  ONLY 

OUT 

(PIOCRAl.A 

The  interrupt  control  word  has: 

bit  7  =  1  to  enable  the  interrupt 

bit  6  =  1  to  generate  an  interrupt  only  if  all  monitored  lines  are  or 

become  active  (a  logical  ANDl 
bit  5  =0  to  specify  that  a  logic  '0'  is  the  active  state  to  be  monitored 
bit  4  =  1  to  indicate  that  a  mask  word  follows  (and  to  reset  pending 

interruptsi 
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4)    Interrupting  control  port  with  vector  located  at  address  28-\q.  An  interrupt  will  be 
generated  if  any  of  the  data  lines  go  high. 


1  n 

All  nm  1 1 1  p 

.iVjMixE;  run  1  b  t^UN  !  nUL 

OUT 

(PIOCRB),A 

LD 

A.OFFH 

:ALL  LINES  INPUTS 

OUT 

(PIOCRB),A 

LD 

A,28H 

;VECTOR  ADDRESS  =  28  HEX 

OUT 

(PIOCRBl.A 

LD 

A.10110111B 

; ENABLE  INTERRUPTS 

OUT 

(PIOCRBj.A 

SUB 

A 

:MONITOR  ALL  LINES 

OUT 

(PIOCRBl.A 

The  interrupt 

control  word  has: 

bit  7  =  1  to  enable  the  interrupt 

bit  6  =0  to  generate  an  interrupt  if  any  monitored  lines  become  actiye 
(a  logical  OR) 

bit  5  =  1  to  specify  that  a  logic  'T  is  the  active  state  to  be  monitored 
bit  4  =  1  to  indicate  that  a  mask  word  follows  (and  to  reset  pending 
interrupts). 

Obviously  a  repeated  Block  Output  instruction  could  be  used  to  shorten  these  programs 
considerably.   


DAISY 

CHAINING 

PIO 

INTERRUPTS 


PIO  DAISY 

CHAIN 

SIGNALS 


Each  PIO  also  has  a  single  interrupt  output  and  enable  signals 
for  daisy  chaining.  The  INT  output  is  active-low  when  the  PIO 
has  an  interrupt  request.  The  enable  signals  are: 

lEl'  (Interrupt  Enable  In)  —  high  if  no  other  devices  of  higher   

priority  are  being  serviced  by  a  CPU  interrupt  service  routine. 

lEO  (Interrupt  Enable  Out)  —  high  if  lEI  is  high  and  the  CPU  is  not  servicing  an  interrupt 
from  this  PIO 

IE!  and  lEO  can  be  used  to  form  a  daisy  chain  (see  Volume  1  of  An 
Introduction  to  Microcomputers)  in  which  PIOs  and  other  devices 
that  are  connected  to  the  chain  closer  to  the  CPU  can  block  inter- 
rupt requests  from  devices  further  from  the  CPU.  The  advantages 
of  the  daisy  chain  are: 

1)  It  identifies  each  source  uniquely. 

2)  It  requires  no  other  hardware. 

3)  It  is  easy  to  expand  or  rearrange  in  hardware. 
The  disadvantages  of  the  daisy  chain  are: 

1)  It  can  be  varied  or  changed  only  in  hardware. 

2)  It  does  not  provide  for  eventual  servicing  of  low  priority  in- 
terrupts. 

3)  It  requires  extra  time  because  signals  must  ripple  through  the  chain. 

The  Z80  automatically  waits  long  enough  for  the  signals  to  ripple  through  a  chain  of  up 
to  four  devices  when  operating  in  Interrupt  Mode  2.  Additional  hardware  can  be  added 
to  allow  longer  chains. 


ADVANTAGES 
AND 

DISADVANTAGES 
OF  DAISY  CHAIN 
INTERRUPTS 
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DEVICE 
OPERATION 
IN  A  DAISY 
CHAIN 


Note  that  a  particular  device  in  the  chain  operates  as  follows: 

1)  It  places  Its  interrupt  vector  on  the  bus  during  an  Interrupt 
Acknowledge  cycle  only  if  it  has  a  pending  interrupt  re- 
quest and  Interrupt  Enable  In  is  high  (indicating  no  higher 
priority  devices  are  being  serviced).  Interrupt  Enable  Out  is 

also  set  low.  Within  a  device.  Port  A  interrupts  take  precedence  over  Port  B  inter- 
rupts. 

2)  It  subsequently  brings  its  Interrupt  Enable  Out  high  (enabling  lower  priority 
devices)  only  if  a  RETI  instruction  is  executed  while  its  Interrupt  Enable  In  is  high. 

Thus,  a  particular  device  will  be  serviced  only  when  it  has  the  highest  priority  request 
and  will  block  lower-prioritv  requests  until  its  service  routine  has  been  completed.  A 
higher-priority  device  can  interrupt  a  lower-priority  service  routine  without  any 
difficulty.  Note  that  a  RETI  instruction  at  the  end  of  the  high  priority  routine  will  not  be 
recognized  by  the  lower-pnoritv  device. 

SIO  INTERRUPTS 

The  SIO  can  also  serve  as  a  source  for  interrupts.  You  should  note 
the  following  features  of  the  SIO  interrupt-based  systems: 

1)  The  transmitter  interrupt  is  enabled  by  setting  bit  1  of  Write 
Register  1  on  each  channel. 

2)  The  interrupt  vector  is  affected  by  bits  2,  3.  and  4  of  Write  Register  1  according  to 
Tables  12-2  and  12-3. 

3)  The  interrupt  vector  is  in  Write  Register  2  on  Channel  B  only.  It  can  be  read  from 
Read  Register  2  on  Channel  B  only. 

4)  Bit  D1  of  Read  Register  0  on  Channel  A  is  1  if  any  interrupt  condition  is  presenMf 
the  entire  SIO. 

Within  an  SIO,  Channel  A  interrupts  have  priority  over  Channel  B  interrupts,  receiver  in- 
terrupts have  priority  over  transmitter  interrupts,  and  transmitter  interrupts  have 
priority  over  external  or  status  interrupts. 

SIOs  can  be  used  in  a  polling  interrupt  system.  The  CPU  must 
check  each  SIO  for  activity  by  examining  bit  1  of  Read  Register  9 
on  Channel  .A.  i.e.. 


SIO 

INTERRUPTS 


SUB 

OUT 

IN 

BIT 

JR 


A 

(SIOCRA),A 
A,(SIOCRA) 
l.A 

NZ.SERVE 


;ACCESS  READ  REGISTER  0 

;GET  SIO  STATUS 

;ANY  INTERRUPTS  PENDING? 

:YES,  INTERRUPT  ACTIVE 


POLLING 
INTERRUPT 
SYSTEMS 
WITH  SIOs 


The  important  features  of  a  Z80  polling  system  are: 

1)  The  first  interrupt  examined  has  the  highest  priority,  since  the  remaining  interrupts 
will  not  be  examined  if  the  first  one  is  active.  The  second  interrupt  has  the  next 
highest  priority,  and  so  on. 

2)  The  service  routine  must  clear  the  SIO  interrupt  by  reading  or  writing  the  appropri- 
ate data  register  even  if  a  data  transfer  is  otherwise  unnecessary. 
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Table  12-2.  Further  Vectoring  of  SIO  Interrupts 
(Bit  2  of  SIO  Write  Register  1  on  Channel  B  is  1) 


Status  Affects  Vector  (D2)  {Channel  B  Only) 

if  this  bit  rs  1.  the  vector  returned  from  an  mtenijpt  acknowtedge  cycle  will  be  vanable  according  to  the  following: 


V3 

V2 

V1 

Ch  B 

0 
0 
0 
0 

0 
0 
1 
1 

0 

1 

0 

1 

Ch  B  Transmit  Buffer  Empty 
Ch  B  External/Status  Change 
Ch  B  Receive  Character  Available 
Ch  B  Special  Receive  Condition* 

Ch  A 

1 
1 
1 
1 

0 
0 
1 
I 

0 

1 

0 

Ch  A  Transmit  Buffer  Empty 
Ch  A  External/Status  Change 
Ch  A  Receive  Character  Available 
Ch  A  Special  Receive  Condition* 

•Special  Receive  Conditions  - 


Parity  Error  or 
Rx  Overrun  Error  or 
CRC/Framing  Error  or 
End  of  Frame  (SDLC) 


If  this  bit  is  0.  the  fixed  vector  programmed  in  the  Interrupt  Vector  register  is  retumed. 


Table  12-3.  SIO  Interrupt  Modes 
(Bits  3  and  4  of  Write  Register  II 

Rec  Int  Mode  0  IDS),  Rec  Int  Mode  1  ID4) 

Receive  Interrupt  Mode  0  and  Receive  Interrupt  Mode  1  together  specify  the  vanous  character  available  conditions; 


D4 

03 

Mode 

Rec  Int 

Rec  Int 

Mode  1 

Mode  0 

0 

0 

0 

Receiver  intemipts  disabled 

1 

0 

1 

Receive  interrupt  on  first  character 

only  en-or 

2 

1 

0 

Intenupt  on  all  Receive  Characters- 

Panty  entsr  affects  Vector 

3 

1 

1 

Interrupt  on  all  Receive  Characters- 

Parity  error  does  not  affect  Vector 
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INTERRUPT  EXAMPLES 

A  Startup  Interrupt 

Purpose:  The  computer  waits  for  a  PIO  interrupt  to  occur  before  starting  actual  opera- 


Many  systems  remain  Inactive  until  the  operator  actually  starts  them  or  a  DATA  READY 
signal  is  received  On  RESET,  such  systems  must  initialize  the  Stack  Pointer,  enable  the 
startup  interrupt,  and  execute  a  HALT  instruction.  Remember  that  RESET  disables  the 
processor  interrupt  and  power-on  disables  all  PIO  interrupts.  In  the  flowchart,  the  deci- 
sion as  to  whether  startup  is  active  is  made  in  hardware  (i.e..  by  the  CPU  examining  the 
interrupt  input  internally)  rather  than  in  software. 

Flowchart: 


tions. 


I 


Initialize  Stack  Pointer 
Enable  startup 


inten-upt  on  PiO 
Enable  GPU  inten-upt 


Source  Program: 


Mam  Program: 


RESET  EQU 


0 

RESET 

SP.100H  ;PUT  STACK  AT  END  OF  MEMORY 

A,01001111B     :PUT  PIO  IN  INPUT  MODE 
(PIOCRA).A 

A,10000111B     ;ENABLE  PIO  INTERRUPT 
(PIOCRA).A 


ORG 

LD 

LD 

OUT 

LD 

OUT 

El 


:ENABLE  INTERRUPTS 
;AND  WAIT 


HALT 


Interrupt 


Service  Routine: 


ORG 

LD 

JP 


INTRP 

SP.100H 

START 


:REINITIALIZE  STACK  POINTER 
;START  MAIN  PROGRAM 
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Object  Program: 


Memory  Address      Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

Main  Program; 

0000 

O  1 

LD 

SP.IuOH 

nnni 

nn 

nnn9 

u  i 

UuUO 

QC 
OC 

LD 

A.OIOOl  1 1 1 B 

CinciA 

UUUf 

'tr 

0005 

D3 

OUT 

(PIOCRA),A 

0006 

PIOCRA 

0007 

3E 

LD 

A.10000111B 

Anno 

uuuy 

Q*7 

o/ 

uuuy 

Do 

OUT 

(PIOCRA), A 

AAA  A 

UUUA 

riUuHA 

AAAD 

UUUd 

rti 

El 

UUUL. 

/D 

HALT 

Interrupt  Service  Routine; 

INTRP 

31 

LD 

SP.IOOH 

iNTRP+1 

00 

INTRP+2 

01 

INTRP+3 

C3 

JP 

START 

INTRP+4 

!NTRP-f5 

START 

The  main  program  must  initialize  the  Stack  Pointer,  since  the  interrupt  response  always 
stores  the  old  Program  Counter  in  the  Stack.  Here  the  service  routine  simply  reinitializes 
the  Stack  Pointer  before  the  actual  startup  routine  is  executed.  An  alternative  would  be 
to  increment  the  Stack  Pointer  twice  before  jumping  to  the  startup  routine.  Remember 
that  the  Z80  comes  up  in  Interrupt  Mode  0.  .Any  other  mode  would  require  the  execu- 
tion of  an  IM  instruction. 


INTERRUPTS  ON 

PARTICULAR 

MICROCOMPUTERS 


The  exact  location  of  the  interrupt  service  routine  varies 
with  the  microcomputer.  If  your  microcomputer  has  no 
monitor,  you  can  start  the  interrupt  service  routine 
wherever  the  external  hardware  or  vector  table  directs  the 
CPU.  Of  course,  you  should  place  the  routine  so  that  it  does  not  interfere  with  fixed  ad 
dresses  or  with  other  programs. 

If  your  microcomputer  has  a  monitor,  the  monitor  will  often  oc- 
cupy the  RESET  and  interrupt  service  addresses.  It  will  then  supply 
service  routines  or  the  addresses  of  those  routines.  A  typical  moni- 
tor routine  initialization  would  be: 


INTERRUPT 
HANDLING 
BY 

MONITORS 


MONIN-.  PUSH 
LD 
JP 


HL 

HL.USRINT 
(HL) 


SAVE  OLD  REGISTER  CONTENTS 
GET  USER  ADDRESS  FOR  SERVICE 
JUMP  TO  USER  SERVICE  ADDRESS 


You  must  then  place  the  address  of  your  service  routine  into  memory  locations  USRINT 
and  USRINT-H.  using  the  normal  Z80  address  format  with  the  least  significant  bits  at 
the  lower  address.  Remember  that  MONIN  is  an  address  in  the  monitor  program. 
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You  can  include  the  loading  of  memorv  locations  USRINT  and  USRINT+1  in  your  main 
program;  i.e.. 

LD  HLINTRP  ;GET  STARTING  ADDRESS  OF  SERVICE 

.  ROUTINE 

LD  (USRINT),HL       ;STORE  IT  AS  USER  ADDRESS 

These  instructions  come  before  the  enabling  of  the  interrupts. 

In  this  example,  the  return  address  that  the  Z80  stores  in  the  Stack  is  not  useful. 
However,  the  mam  program  still  must  initialize  the  Stacl<  Pointer  so  that  there  is  a 
definite  place  to  put  that  address.  You  may  not  need  the  LD  SP  instruction  if  the  moni- 
tor in  your  microcomputer  manages  the  Stacl<  Pointer. 

The  main  program  enables  only  the  interrupt  from  the  startup  PIO.  The  PIO  could,  of 
course,  be  in  any  mode.  The  interrupt  is  enabled  by  setting  bit  7  of  an  interrupt  control 
word  and  writing  that  word  to  the  PIO  control  port.  The  PIO  interrupt  is  enabled  before 
the  overall  interrupt  system  is  enabled  with  the  El  instruction. 


Remember  that  RESET  and  accepting  an  interrupt  automatically  disable  the  interrupt 
system.  This  allows  the  real  startup  routine  to  configure  all  the  PIOs  and  other  interrupt 
sources  without  being  interrupted. 

No  action  is  needed  in  the  interrupt  service  routine,  since  the  interrupt  is  automatically 
cleared  as  part  of  the  interrupt  Acknowledge  cycle  involving  a  particular  PIO. 

The  implementations  of  the  instructions  El  (Enable  Interrupts)  and  Dl  (Disable  Inter- 
rupts) differ  on  the  Z80.  Dl  takes  effect  immediately  after  its  execution,  while  El  takes 
effect  after  the  execution  of  the  following  instruction.  The  reasoning  behind  this  fact  is 
discussed  in  Chapter  3  under  the  description  of  the  El  instruction. 

A  Keyboard  Interrupt 

Purpose:  The  computer  waits  for  a  keyboard  interrupt  and  places 
?  the  data  from  the  keyboard  into  memory  location  0040. 

Sample  Problem: 

Keyboard  data  =  06 
Result:       (0040)  =  06 
Flowchart: 


KEYB0AFID> 
INTERiUPT 


C 


Initialize  Stack  Pointeri 
Enable  keyDoard  I 
imerrupt  an  HiO  | 
Enable  CPU  inten-upt  1 
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Source  Program: 


Main  Program: 


HERE: 
Interrupt 


EQU 

0 

ORG 

RESET 

LD 

SP.100H 

:PUT  STACK  AT  END  OF  MEMORY 

LD 

A,01001111B 

:PUT  PIO  IN  INPUT  MODE 

OUT 

(PIOCRA),A 

LD 

A,10000111B 

;ENABLE  PIO  INTERRUPTS 

OUT 

(PIOCRAi.A 

El 

:  ENABLE  CPU  INTERRUPTS 

JR 

HERE 

;DUMMY  MAIN  PROGRAM 

Service  Routine: 

ORG 

INTRP 

EX 

AF.AF' 

:SAVE  ACCUMULATOR,  FLAGS 

IN 

A.IPIODRAI 

:GET  KEYBOARD  DATA 

LD 

(40H),A 

:SAVE  KEYBOARD  DATA 

EX 

AF.AF 

:  RESTORE  ACCUMULATOR.  FLAGS 

El 

:RE-ENABLE  INTERRUPTS 

RETI 


Object  Program: 


Memory  Address 

Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

Main  Program: 

0000 

31 

LD 

SP.100H 

0001 

00 

0002 

01 

0003 

3E 

LD 

A.01001111B 

0004 

4F 

0005 

D3 

OUT 

(PIOCRA).A 

0006 

PIOCRA 

0007 

3E 

LD 

A.iooooniB 

0008 

87 

0009 

D3 

OUT 

(PIOCRA).A 

OOOA 

PIOCRA 

OOOB 

FB 

El 

OOOC 

18  HERE: 

JR 

HERE 

OOOD 

FE 

InterruDt  Service  Routine: 

INTRP 

08 

EX 

AF.AF 

INTRP+1 

DB 

IN 

A,  (PIODRA) 

INTRP+2 

PIODRA 

INTRP+3 

32 

LD 

(40H),A 

INTRP+4 

40 

INTRP+5 

00 

INTRP+6 

08 

EX 

AF.AF 

INTRP+7 

FB 

El 

INTRP+8 

ED 

RETI 

INTRP+9 

4D 
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The  JR  HERE  is  an  endless  loop  (jump-to-self)  instruction  that  is  used  to  represent  the 
mam  program.  After  interrupts  are  enabled  in  a  working  system,  the  main  program  goes 
about  its  business  until  an  interrupt  occurs  and  then  resumes  execution  after  the  Inter- 
rupt service  routine  is  completed. 


The  RET  instruction  at  the  end  of  the  sen/ice  routine  transfers       CHANGING  THE 
control  back  to  the  JR  instruction.  If  vou  want  to  avoid  this,  you  RETURN 
can  simply  increment  the  Program  Counter  in  the  Stack,  e.g..  ADDRESS 

EX  !SP),HL  ;GET  RETURN  ADDRESS 

INC  HL  :INCREMENT  RETURN  ADDRESS  TWICE 

INC  HL 

EX  (SP),HL  :  RESTORE  ADJUSTED  ADDRESS  TO  STACK 

The  RET  instruction  will  now  transfer  control  to  the  instruction  following  the  JR.  Note 
the  use  of  EX  !SP),HL;  this  instruction  exchanges  the  contents  of  Register  Pair  HL  with 
the  contents  of  the  memory  locations  at  the  top  of  the  Stack.  By  using  it,  we  can  adjust 
the  return  address  without  affecting  the  contents  of  Register  Pair  HL. 

Since  the  Z80  does  not  automatioally  save  its  registers,  you  can  use  them  to  pass 
parameters  and  results  between  the  main  program  and  the  interrupt  service  routine.  So, 
you  could  leave  the  data  in  the  Accumulator  instead  of  in  memory  location  0040.  This 
is,  however,  a  dangerous  practice  that  should  be  avoided  in  all  but  the  most  tnvial 
systems.  In  most  applications,  the  processor  is  using  its  registers  during  normal  pro- 
gram execution;  having  the  interrupt  service  routines  randomly  change  the  contents  of 
those  registers  would  surely  cause  havoc.  In  general,  no  interrupt  service  routine  should 
ever  alter  any  register  unless  that  register's  contents  have  been  saved  prior  to  its  altera- 
tion and  will  be  restored  at  the  completion  of  the  routine. 

Note  that  you  must  explicitly  re-enable  the  interrupts  at  the  end  of  the  service  routine, 
since  the  processor  disables  the  interrupt  system  when  it  accepts  an  interrupt.  Servic- 
ing a  PIO  interrupt  deactivates  the  interrupt  signal  so  that  the  same  interrupt  is  not  ser- 
viced again. 


if  interrupt  service  routines  are  never  themselves  interrupted  (i.e.,       I  SAVING 
there  is  only  one  level  of  interrupts),  the  instructions  EX  AF.AF'       I  VALUES  IN 
and  EXX  are  a  convenient  way  to  save  and  restore  the  old  contents       I  PRIMED 
of  the  user  registers.  EXX  exchanges  the  contents  of  BC,  DE,  and       [  REGISTERS 
HL  with  the  contents  of  their  primed  equivalents.  The  two  instruc- 
tions together  take  only  two  bytes  of  memon/  and  eight  clock  cycles.  However,  this 
method  cannot  be  used  if  there  are  other  interrupt  levels  (since  there  is  only  a  single  set 
of  primed  registers!  or  if  the  primed  registers  are  needed  in  either  the  main  program  or 
the  interrupt  service  routine. 

A  more  general  approach  to  saving  and  restoring  registers  is  to  use  the  Stack.  PUSH 
saves  the  contents  of  a  register  pair  and  POP  restores  the  contents.  However,  PUSH 
takes  1 1  clock  cycles  and  POP  10,  so  this  approach  is  slower.  It  also  uses  extra  memory 
locations  in  the  Stack.  The  advantage  of  this  method  is  that  it  can  be  expanded  in- 
definitely (as  long  as  there  is  room  in  the  Stack)  since  nested  service  routines  will  not 
destroy  the  data  saved  by  the  earlier  routines. 

An  alternative  approach  would  be  for  the  interrupt  routine  to 
maintain  control  until  it  received  an  entire  line  of  text  (e.g.,  a  string 
of  characters  ending  with  a  carriage  return).  The  main  program 
would  be: 


FILLING  A 
BUFFER  VIA 
INTERRUPTS 
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Main  Program; 


HERE; 
Interrupt 


cUU 

0 

Unu 

RESET 

1  n 

SP.IOOH           :  PUT  STACK  AT  END  OF  MEMORY 

LD 

A.OIOOIIIIB 

PUT  PIO  IN  INPUT  MODE 

OUT 

(PIOCRAi.A 

LD 

A,  1 00001 1 1 B     ;ENABLE  PIO  INTERRUPTS 

OUT 

(rlUCHAI.A 

LD 

HL, /UH 

(NlliALIi.t  DUrrtn  POINTcn 

LD 

(4UH),HL 

oAVh  DUrFcK  rOINTcR 

El 

ENABLE  CPU  INTERRUPT 

JR 

HERE 

DUMMY  MAIN  PROGRAM 

Service 

Routine; 

Unu 

INTRP 

cv 

AF.AF 

SAVE  A,  FLAGS 

c  vv 

CAA 

SAVE  OTHER  REGISTERS 

LU 

HL,(40H) 

GET  BUFFER  POINTER 

iN 

A,!PIODRA) 

GET  KEYBOARD  DATA 

LU 

(HU.A 

SAVE  DATA  IN  BUFFER 

CR 

IS  DATA  A  CARRIAGE  RETURN? 

ID 

Jn 

Z.ENDL 

YES,  END  OF  LINE 

INC 

HL 

NO,  INCREMENT  BUFFER  POINTER 

LD 

(40Hi,HL 

EXX 

:RESTORE  OTHER  REGISTERS 

EX 

AF.AF' 

RESTORE  A,  FLAGS 

El 

RE-ENABLE  INTERRUPTS 

RET! 

JP 

LPROC 

PROCESS  LINE  WITHOUT  INTERRUPTS 

When  the  processor  receives  a  carriage  return,  it  leaves  the  interrupt  systenn  disabled 
while  It  handles  the  line. 

An  alternative  approach  would  be  to  fill  another  buffer  while  han- 
dling the  first  one;  this  approach  is  called  double  buffering. 

The  line  processing  routine  is  begun  at  address  LPROC  with  inter- 
rupts disabled,  the  old  register  contents  in  the  primed  registers,  and  the  original  return 
address  at  the  top  of  the  Stack. 

In  a  real  application,  the  CPU  could  perform  other  tasks  between  interrupts.  It  could,  for 
instance,  edit,  move,  or  transmit  a  line  from  one  buffer  while  the  interrupt  was  filling 
another  buffer. 

A  Printer  Interrupt 

Purpose:  The  computer  waits  for  a  printer  interrupt  and  sends  the  data  from  memory 
location  0040  to  the  printer. 

Sample  Problem: 

(0040)  =  51 H 

Result;       Printer  receives  a  51H  (ASCII  Q)  when  it  is  ready. 


DOUBLE 
BUFFERING 
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Flowchart: 


Source  Program: 

Main  Program: 


RESET 

EQU 

0 

ORG 

RESET 

LD 

SP.100H 

:PUT  STACK  AT  END  OF  MEMORY 

LD 

A.oooomiB 

:PUT  PIO  IN  OUTPUT  MODE 

OUT 

(PIOCRA),A 

LD 

A,10000111B 

;ENABLE  PIO  INTERRUPTS 

OUT 

(PIOCRA).A 

El 

:ENABLE  CPU  INTERRUPTS 

HERE: 

JR 

HERE 

:DUMMY  MAIN  PROGRAM 

Interrupt  Service  Routine: 

ORG 

INTRP 

EX 

AF.AF 

iSAVE  ACCUMULATOR,  FLAGS 

LD 

A,(40H) 

:GET  DATA 

OUT 

(PIODRAl.A 

:SEND  DATA  TO  PRINTER 

EX 

AF.AF' 

:RESTORE  ACCUMULATOR,  FLAGS 

El 

;RE-ENABLE  INTERRUPTS 

RETI 
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Object  Program: 


Memory  Address     Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

Main  Program: 

0000 

31 

LD 

SP.IOOH 

0001 

00 

0002 

01 

0003 

3E 

LD 

A.00001111B 

0004 

OF 

0005 

D3 

OUT 

(PIOCRAj.A 

0006 

PIOCRA 

0007 

3E 

LD 

A.10000111B 

0008 

87 

0009 

D3 

OUT 

(PIOCRA).A 

OOOA 

PIOCRA 

OOOB 

FB 

El 

OOOC 

18 

HERE:  JR 

HERE 

OOOD 

FE 

Interrupt  Service  Routine: 

INTRP 

08 

EX 

AKAr 

LD 

A,(40H) 

INTRP+2 

40 

INTRP+3 

00 

INTRP+4 

D3 

OUT 

(PIODRAj.A 

INTRP+5 

PIODRA 

INTRP+6 

08 

EX 

AF.AF' 

INTRP+7 

FB 

El 

INTRP+8 

ED 

RETI 

INTRP+9 

4D 

Here,  as  with  the  keyboard,  you  could  have  the  printer  continue  to 
interrupt  until  it  transferred  an  entire  line  of  text.  The  main  pro- 
gram and  the  service  routine  would  be: 

Main  Program: 

RESET 


EMPTYING  A 
BUFFER  WITH 
INTERRUPTS 


HERE: 


ECU 

0 

ORG 

RESET 

LD 

SP.IOOH 

;PUT  STACK  AT  END  OF  MEMORY 

LD 

A.00001 1 1 1 B 

:PUT  PIO  IN  OUTPUT  MODE 

OUT 

(PIOCRA),A 

LD 

A.10000111B 

;ENABLE  PIO  INTERRUPTS 

OUT 

(PIOCRA),A 

LD 

HL,70H 

;INITIALIZE  BUFFER  POINTER 

LD 

(40H),HL 

iSAVE  BUFFER  POINTER 

El 

lENABLE  CPU  INTERRUPT 

JR 

HERE 

:DUMMY  MAIN  PROGRAM 
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Interrupt  Service  Routine: 


ORG 

INTRP 

EX 

AF.AF 

SAVE  A,  FLAGS 

EXX 

SAVE  OTHER  REGJSTERS 

LD 

HL,(40H) 

GET  BUFFER  POINTER 

LD 

A,(HL) 

GET  A  BYTE  OF  DATA  FROM  BUFFER 

OUT 

(PIODRA),A 

SEND  DATA  TO  PRINTER 

CP 

CR 

IS  DATA  A  CARRIAGE  RETURN? 

JR 

ENDL 

YES,  END  OF  LINE 

INC 

HL 

NO,  INCREMENT  BUFFER  POINTER 

LD 

(40H),HL 

EXX 

RESTORE  OTHER  REGISTERS 

EX 

AF.AF' 

RESTORE  A.  FLAGS 

El 

RE-ENABLE  INTERRUPTS 

RETI 

JP 

LCOMP 

HANDLE  COMPLETED  LINE 

ENDL: 

Again,  double  buffering  could  be  used  to  allow  I/O  and  processing  to  occur  at  the  same 
time  without  ever  halting  the  CPU 

A  Real-Time  Clock  interrupt 

Purpose:  The  computer  waits  for  an  interrupt  from  a  real-time 
clock. 


REAL-TtME 
CLOCK 


A  real-time  clock  simply  provides  a  regular  series  of  pulses.  The  in- 
terval between  the  pulses  can  be  used  as  a  time  reference.  Real-time  clock  interrupts 
can  be  counted  to  give  any  multiple  of  the  basic  time  interval.  A  real-time  clock  can  be 
produced  by  dividing  down  the  CPU  clock,  by  using  a  separate  timer  or  a  programma- 
ble timer  like  the  CTC  for  ZBO-based  microcomputers,  or  by  using  external  sources  such 
as  the  -AC  line  frequency.   


FREQUENCY 
OF  REAL-TIME 
CLOCK 


Note  the  tradeoffs  involved  in  determining  the  frequency  of  the 
real-time  clock.  A  high  frequency  Ssay  10  kHz)  allows  the  crea- 
tion of  a  wide  range  of  time  intervals  of  high  accuracy.  On  the 
other  hand,  the  overhead  involved  in  counting  real-time  clock 
interrupts  may  be  considerable,  and  the  counts  will  quickly  exceed  the  capacity  of  a 
single  8-bit  register  or  memory  location.  The  choice  of  frequency  depends  on  the  preci- 
sion and  timing  requirements  of  your  application.  The  clock  may.  of  course,  consist 
partly  of  hardware:  a  counter  may  count  high  frequency  pulses  and  interrupt  the  pro- 
cessor only  occasionally.  A  program  will  have  to  read  the  counter  to  measure  time  to 
high  accuracy. 

One  problem  is  synchronizing  operations  with  the  real-time 
clock.  Clearly,  there  will  be  some  effect  on  the  precision  of 
the  timing  interval  if  the  CPU  starts  the  measurement  ran- 
domly during  a  clock  period,  rather  than  exactly  at  the 
beginning.  Some  ways  to  synchronize  operations  are: 

1) 

2) 
3) 


SYNCHRONIZATION 
WITH  REAL-TIME 
CLOCK 


Start  the  CPU  and  clock  together.  RESET  or  a  startup  interrupt  can  start  the  clock  as 
well  as  the  CPU. 

Allow  the  CPU  to  start  and  stop  the  clock  under  program  control. 
Use  a  high-frequency  clock  so  that  an  error  of  less  than  one  clock  period  will  be 


4)    Line  up  the  clock  (by  waiting  for  an  edge  or  interrupt)  before  starting  the  measure- 
ment. 
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PRIORITY 

OF  REAL-TIME 

CLOCK 


A  real-time  clock  interrupt  should  have  very  high  priority,  since 
the  precision  of  the  timing  intervals  will  be  affected  by  any  delay 
in  servicing  the  interrupt.  The  usual  practice  is  to  make  the  real- 
time clock  the  highest  priority  interrupt  except  for  power  failure. 
The  clock  interrupt  service  routine  is  generally  kept  extremely  short  so  that  it  does  not 
interfere  with  other  CPU  activities. 

a)   Wait  for  Real-Time  Clock 

Source  Program: 

Main  Program; 
RESET 


EQU 

0 

ORG 

RESET 

LD 

SP.100H 

:PUT  STACK  AT  END  OF  MEMORY 

LD 

A.OIOOmiB 

:PUT  PIO  IN  INPUT  MODE 

OUT 

(PIOCRALA 

LD 

A.IOOOOIIIB 

;ENABLE  PIO  INTERRUPTS 

OUT 

!PIOCRA),A 

El 

;ENABLE  CPU  INTERRUPTS 

JR 

HERE 

:DUMMY  MAIN  PROGRAM 

HERE: 

Interrupt  Service  Routine: 

ORG  INTRP 
HALT 

Object  Program: 


:END  CLOCK  INTERRUPT 


Memory  Address      Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

Main  Program: 

0000 

31 

LD 

SP.IOOH 

0001 

00 

0002 

01 

0003 

3E 

LD 

A.01001111B 

0004 

4F 

0005 

03 

OUT 

(PIOCRA),A 

0006 

PIOCRA 

0007 

3E 

LD 

A.10000111B 

0008 

87 

0009 

D3 

OUT 

(PIOCRA),A 

OOOA 

PIOCRA 

OOOB 

FB 

El 

OOOC 

18  HERE: 

JR 

HERE 

OOOD 

FE 

Interrupt  Service  Routine: 

INTRP 

76 

HALT 

The  service  routine  does  not  have  to  do  anything,  since  servicing  the  PIO  interrupt  auto- 
matically clears  it  and  there  is  no  data  to  send  or  receive. 

The  real-time  clock  interrupt  always  occurs  on- a  rising  edge  if  a  PIO  STROBE  signal  is 
used  for  the  clock  input. 
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b)   Wait  for  10  Real-Time  Clocic  Interrupts 
Source  Program: 

Main  Program: 

RESET      EQU  0 

ORG  RESET 

LD  SP.IOOH            :PUT  STACK  AT  END  OF  MEMORY 

LD  A.01001111B     :PUT  PIO  IN  INPUT  MODE 

OUT  (PIOCRAKA 

LD  A.  1 00001 1 1 B     lENABLE  PIO  INTERRUPTS 

OUT  |PIOCRA),A 

LD  HL.40H             .-CLOCK  COUNTER  =  ZERO 

LD  (HU.O 

LD  A,10                :  NUMBER  OF  COUNTS  =  10 

El  ;ENABLE  CPU  INTERRUPTS 

WTTEN:   CP  (HL)                 ;HAVE  TEN  COUNTS  ELAPSED? 

JR  NZ.WTTEN         ;N0,  WAIT 

HALT  :YES,  DONE 
Interrupt  Service  Routine: 

ORG  INTRP 

EXX  ;SAVE  USER  REGISTERS 

EX  AF.AF'              ;SAVE  A,  FLAGS 

LD  HL,40H             :INCREMENT  CLOCK  COUNTER 

INC  (HL) 

EX  AF.AF              :  RESTORE  A,  FLAGS 

EXX  :RESTORE  USER  REGISTERS 

El  ;RE-ENABLE  INTERRUPTS 
RETI 
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Object  Program: 


Memory  Address      Mfemory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

Mam  Program: 

0000 

31 

LD 

SP.IOOH 

0001 

00 

0002 

01 

0003 

3E 

LD 

A.OlOOmiB 

0004 

4F 

0005 

D3 

OUT 

(PIOCRA),A 

0006 

PIOCRA 

0007 

3E 

LD 

A,10000111B 

0008 

87 

0009 

D3 

OUT 

(PIOCRA),A 

OOOA 

PIOCRA 

OOOB 

21 

LD 

HL.40H 

OOOC 

40 

OOOD 

00 

OOOE 

36 

LD 

(HD.O 

OOOF 

00 

0010 

3E 

LD 

A.IO 

001 1 

OA 

0012 

FB 

El 

0013 

BE 

WTTEN:  CP 

(HL) 

0014 

20 

JR 

NZ.WTTEN 

0015 

FD 

0016 

76 

HALT 

Interrupt  Service  Routine: 

INTRP 

□9 

EXX 

lNTRP+1 

08 

EX 

AF.AF' 

tMTRP-4-9 
1  IN  1  ni 

21 

LD 

HL.40H 

INTRP+3 

40 

INTRP+4 

00 

INTRP+5 

34 

INC 

(HL) 

INTRP+6 

08 

EX 

AF.AF- 

INTRP+7 

D9 

EXX 

INTRP+8 

FB 

El 

INTRP+9 

ED 

RETI 

lNTRP+10 

4D 

An  alternative  approach  uses  the  Stack  to  save  and  restore  register  values.  To  save  H.  L, 
and  the  flags  requires: 

PUSH       HL  :SAVE  REGISTERS  H  AND  L 

PUSH       AF  :SAVE  ACCUMULATOR  AND  FLAGS 


To  restore  them  requires  the  sequence: 

POP        AF  :RESTORE  ACCUMULATOR  AND  FLAGS 

POP        HL  :RESTORE  REGISTERS  H  AND  L 

Note  that,  if  the  Stack  is  used,  registers  must  be  restored  in  the  opposite  order  from  that 
in  which  they  were  saved.  Clearly  the  order  in  which  EXX  and  EX  AF.AF'  are  executed 
does  not  matter. 
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MAINTAINING 
REAL  TIME 


This  interrupt  service  routine  nnerelv  updates  the  counter  m  memorv  location  0040.  it  is 
transparent  to  the  mam  program.   

A  more  realistic  real-time  clock  interrupt  routine  could 
maintain  real  time  in  several  memory  locations.  For  exam- 
ple, the  following  routine  uses  addresses  0040  through  0043 
as  follows: 

0040  -    hundredths  of  seconds 

0041  -  seconds 

0042  -  minutes 

0043  -  hours 

We  assume  that  the  routine  is  triggered  by  a  100  Hz  clocl<. 
Flowchart: 


CZHZ) 


Clear  clock  interrupt 
Hundredths  = 
Hundredths  +  1 


Hundredths    =  0 
Seconds  = 
Seconds  +  1 
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Source  Program: 


DONE: 


ORG 

INTRP 

PUSH 

AF                  :SAVE  REGISTERS 

PUSH 

HL 

LD 

HL,40H              :UPDATE  HUNDREDTHS  OF  SECONDS 

INC 

IML) 

LD 

A,  1 00 

CP 

(HL) 

lb  THbRb  A  CAHHY  TO  btCONDSf 

JR 

N/L,UUNb 

NO.  DONE 

LD 

(HL).O 

YES.  HUNDREUTHS  =  0 

INC 

HL 

UPDATE  SECONDS 

INC 

(HL) 

LD 

A,  60 

CP 

(HL) 

IS  THERE  A  CARRY  TO  MINUTES? 

JR 

NZ.DONE 

NO.  DONE 

LD 

(HD.O 

YES.  SECONDS  =  0 

INC 

HL 

UPDATE  MINUTES 

INC 

(HL) 

CP 

(HL) 

IS  THERE  A  CARRY  TO  HOURS? 

JR 

NZ  DONF 

NO  nONF 

LD 

(HU.O 

YES.  MINUTES  =  0 

INC 

HL 

UPDATE  HOURS 

INC 

(HL) 

1  n 

A.24 

DAY  COMPLETED? 

JR 

NZ.DONE 

NO,  DONE 

LD 

(HU.O 

YES,  HOURS  =  0 

POP 

HL 

RESTORE  REGISTERS 

POP 

AF 

El 

RE-ENABLE  INTERRUPTS 

RETI 

it  of  300  ms  could  be  produced  in  the  mam  program  with  the  routine: 

LD 

HL.40H 

GET  PRESENT  TIME  (HUNDREDTHS  OF  SECS) 

LD 

A.(HL) 

ADD 

A.30 

DESIRED  TIME  IS  30  COUNTS  LATER 

CP 

100 

MOD  100 

JR 

C.WT30 

SUB 

100 

CP 

(HL) 

DESIRED  TIME  REACHED? 

JR 

NZ,WT30 

NO,  WAIT 

WT30: 


Be  careful  in  this  program  of  the  difference  between  INC  HL  and  INC  (HL).  INC  HL  adds 
1  to  the  16-bit  contents  of  Register  Pair  HL,  while  INC  (HL)  adds  1  to  the  8-bit  contents 
of  the  memory  location  addressed  by  HL. 

Of  course,  the  program  could  perform  other  tasks  and  check  the  elapsed  time  only  oc- 
casionally. How  would  you  produce  a  delay  of  seven  seconds?.  Of  three  minutes? 

Sometimes  you  may  want  to  keep  time  either  as  BCD  digits  or  as  ASCII  characters.  How 
would  you  revise  the  last  program  to  handle  these  alternatives? 

You  can  disable  the  clock  interrupt  (or  any  other  interrupt)  when  it 
IS  no  longer  needed  in  any  of  the  following  ways. 

1)  By  executing  a  Dl  instruction  in  the  main  program.  This  disa- 
bles the  entire  interrupt  system. 

2)  By  clearing  bit  7  of  the  interrupt  control  word  during  the  service  routine  or  during 
the  main  program.  This  disables  only  the  interrupt  from  one  port  of  one  PIO, 


DISABLING 
INTERRUPTS 
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3(   By  not  re-enabling  the  interrupt  during- the  service  routine. 

Rennember  that  the  CPU  automatically  disables  interrupts  upon  accepting  one.  Thus, 
the  interrupt  system  is  disabled  unless  the  service  routine  explicitly  re-enables  it.  Note, 
however,  that  you  must  be  very  careful  about  not  re-enabling  the  interrupts,  since  the 
main  program  would  be  completely  unaware  that  interrupts  were  no  longer  allowed.  In 
general,  all  interrupt  service  routines  should  re-enabie  the  interrupts  before  return- 
ing; any  other  policy  means  that  the  service  routines  are  not  transparent  to  the  mam 
program. 

A  Teletypewriter  Interrupt 

Purpose:  The  computer  waits  for  data  to  be  received  from  a  teletypewriter  and  stores 
the  data  in  memory  location  0040. 

a)   Using  an  SIO 

(7-bit  characters  with  odd  parity  and  2  stop  bits). 
Source  Program: 


lACCESS  WRITE  REGISTER  4 


SIO 

INTERRUPT 
ROUTINE 


Main  Program: 

RESET 

EQU 

0 

LD 

A,4 

OUT 

(SIOCRA),A 

LD 

A,01 000001 B 

OUT 

(SIOCRALA 

LD 

A,3 

OUT 

(SIOCRA),A 

LD 

A.01 000001 B 

OUT 

(SIOCRAKA 

LD 

A,1 

OUT 

(SIOCRA),A 

LD 

A.OOOnOOOB 

OUT 

(SIOCRA),A 

El 

HERE: 

JR 

HERE 

Interrupt 

Service  Routine: 

ORG 

INTRP 

PUSH 

AF 

IN 

A,(SIODRA| 

LD 

(40H),A 

POP 

AF 

El 

RETI 

;X16  CLOCK  MODE,  PARITY 


:7  BIT  CHARACTERS,  ENABLE  RECEIVER 

lACCESS  WRITE  REGISTER  1 

lENABLE  RECEIVER  INTERRUPT  ON  ALL  CHARS 

lENABLE  CPU  INTERRUPTS 
:DUMMY  MAIN  PROGRAM 


SAVE  ACCUMULATOR,  FLAGS 
READ  CHARACTER  FROM  SIO 
SAVE  CHARACTER  IN  MEMORY 
RESTORE  ACCUMULATOR,  FLAGS 
RE-ENABLE  INTERRUPTS 
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Object  Program: 


Memory  Address      Memory  Contents 

Instruction 

(Hex) 

(Hex) 

(Mnemonic) 

Main  Prnnranr 

0000 

3E 

LD 

A.4 

0001 

04 

0002 

D3 

OUT 

(SIOCRA),A 

0003 

SIOCRA 

0004 

3E 

LD 

A,01 000001 B 

0005 

41 

0006 

D3 

OUT 

(SIOCRA),A 

0007 

SIOCRA 

0008 

3E 

LD 

A.3 

0009 

03 

OOOA 

D3 

OUT 

(SIOCRA),A 

OOOB 

SIOCRA 

OOOC 

3E 

LD 

A,01 000001 B 

OOOD 

41 

OOOE 

D3 

OUT 

(SIOCRA).A 

OOOF 

SIOCRA 

0010 

3E 

LD 

A.1 

0011 

01 

0012 

D3 

OUT 

(SIOCRA),A 

001 3 

blOCHA 

0014 

3E 

LD 

A,00011000B 

0015 

18 

0016 

D3 

OUT 

(SIOCRAi.A 

0017 

SIOCRA 

0018 

FB 

El 

0019 

18 

HERE:  JR 

HERE 

001 A 

FE 

Intprriint  ^Pfvipp  Rnutinp' 

INTRP 

F5 

PUSH 

AF 

INTRP+1 

DB 

IN 

A,{SIODRA) 

olUL/nM 

INTRP+3 

32 

LD 

(40H),A 

INTRP+4 

40 

INTRP+5 

00 

INTRP+6 

F1 

POP 

AF 

INTRP+7 

FB 

El 

INTRP+8 

ED 

RET! 

INTRP+9 

4D 

This  service  routine  assumes  that  only  the  receive  interrupt  from  one  channel  of  the  SIO 
has  been  enabled.  Otherwise,  either  further  vectoring  w/ill  be  required  by  changing  con- 
trol bits  D2.  D3,  and  D4  of  Write  Register  0  (see  the  discussion  of  SIO  interrupts  earlier 
in  this  chapter)  or  the  routine  will  have  to  examine  the  status  bits  in  Read  Register  0. 
The  kev  status  bits  are: 

Bit  0  -  Receive  Character  Available  —  1  when  at  least  one  character  is  available  in  the 
receive  buffers. 

Bit  1  -  Interrupt  pending  (Channel  A  only)  —  1  if  any  interrupt  is  pending  in  the  entire 
SIO. 
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Bit  2  -  Transmit  Buffer  Empty  —  1  if  tlie  Transmit  buffer  is  empty. 

Obviously,  it  would  be  far  shorter  and  simpler  to  configure  the  SIO  by  using  a  table  (in 
ROM)  and  the  repeated  Block  I/O  instruction,  i.e., 


LD 
LD 
LD 
OTIR 


B.6 

CSIOCRA 
HL,SIOTBL 


NUMBER  OF  BYTES  IN  CONFIGURATION 
SIO  CONTROL  PORT 
START  OF  SIO  CONFIGURATION  TABLE 
CONFIGURE  SIO 


This  method  requires  9  bytes  of  memory  for  the  program  and  6  bytes  for  the  table,  as 
compared  to  the  23  bytes  used  in  the  example  to  configure  the  SIO. 

The  program  establishes  the  SIO  registers  as  follows: 

WRITE  REGISTER  4 

Bit  7  =  0,  bit  6  =  1  for  XI 6  clock  mode 
Bit  1  =  0  to  select  odd  parity 
Bit  0  =  1  to  enable  parity  generation 
WRITE  REGISTER  3 

Bit  7  =  0,  bit  6  =  1  to  select  7-bit  characters 
Bit  0  =  1  to  enable  the  receiver 
WRITE  REGISTER  1 

Bit  4  =  1 ,  bit  3  =  1  to  produce  an  interrupt  on  all  received  characters  with  parity  errors 
not  affecting  the  vector. 

The  CPU  clears  the  Received  Character  Available  bit  by  reading  a  character  from  the 
SIO  Data  register.  The  Interrupt  Pending  bit  is  cleared  automatically  when  the  interrupt 
is  serviced. 

b)    Using  a  PIO 

(Received  data  tied  to  data  bit  7  of  PIO  Port  A). 
Source  Program: 

Main  Program: 


START  BIT 
INTERRUPT 


HERE: 


LD 

A,11001111B 

:MAKE  PORT  A  CONTROL 

OUT 

(PIOCRA),A 

LD 

A,10000000B 

:MAKE  BIT  7  INPUT,  OTHERS  OUTPUTS 

OUT 

(PIOCRA),A 

LD 

A,10010111B 

;ENABLE  INTERRUPT  ON  START  BIT  (0) 

OUT 

(PIOCRA),A 

LD 

A.01111111B 

:MASK  OUT  ALL  OTHER  BITS 

OUT 

(PIOCRA),A 

El 

:ENABLE  CPU  INTERRUPTS 

JR 

HERE 

:DUMMY  MAIN  PROGRAM 

Service  Routine: 

ORG 

INTRP 

PUSH 

AF 

:SAVE  ACCUMULATOR,  FLAGS 

LD 

A,00000111B 

:DISABLE  START  BIT  INTERRUPT 

OUT 

(PIOCRAIA 

CALL 

TTYRCV 

:FETCH  DATA  FROM  TTY 

LD 

A,10000111B 

:ENABLE  START  BIT  INTERRUPT 

OUT 

(PIOCRA),A 

POP 

AF 

:  RESTORE  ACCUMULATOR.  FLAGS 

El 

:RE-ENABLE  INTERRUPTS 

RETI 
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Object  Program: 


Memory  Address     Memory  Contents 

Instruction 

(Hex) 

(Mnemonic) 

Mam  Program: 

0000 

3E 

LD 

A.I  1001 1 1 1 B 

0001 

CF 

0002 

D3 

OUT 

IPIOCRAj.A 

0003 

PIOCRA 

0004 

3E 

LD 

A,  1 0OOOOOOB 

0005 

80 

0006 

D3 

OUT 

(PIOCRAJ.A 

0007 

PIOCRA 

0008 

3E 

LD 

A,  JuUlU 1  lib 

0009 

97 

OOOA 

D3 

OUT 

{P!OCRA),A 

OOOB 

PIOCRA 

UOUL 

ob 

LD 

A,01 1 1 11 11B 

OOOD 

7p 

OOOE 

D3 

OUT 

(PIOCRA), A 

OOOF 

PinCRA 

0010 

FB 

El 

001 1 

18 

HERE;  JR 

HERE 

001 2 

PE 

Interrupt  Seryice  Routine: 

INTRP 

F5 

PUSH 

AF 

|MTRp-l-l 

11^1111     I  ' 

3E 

LL) 

A  AAAAAI  1  1 D 

A.UUUUU  !  !  t  D 

INTRP+2 

07 

INTRP+3 

D3 

IT 

UU  1 

INTRP+4 

PIOCRA 

INTRP+5 

CD 

INTRP+6 

TTYRCV 

INTRP+7 

INTRP+8 

3E 

LD 

A.IOOOOIIIB 

INTRP+9 

87 

INTRP+10 

D3 

OUT 

(PIOCRAl.A 

lNTRP+11 

PIOCRA 

INTRP+12 

F1 

POP 

AF 

INTRP+13 

FB 

El 

INTRP+14 

ED 

RET! 

INTRP+15 

4D 

These  programs  assume  that  the  monitor  initializes  the  Stack  Pointer.  Otherwise,  it  will 
haye  to  be  loaded  m  the  mam  program. 

Subroutine  TTYRCV  is  the  TTY  receive  routine  shown  in  the  previous  chapter. 


The  edge  used  to  cause  the  interrupt  is  very  important  here.  An  interrupt  must  occur 
when  the  data  line  changes  from  the  normal  MARK  or '1'  state  to  the  SPACE  or  '0'  state, 
since  this  transition  identifies  the  start  of  the  transmission. 

The  service  routine  must  disable  the  PIO  interrupt,  since  otherwise  each  '1'-to-'0'  tran- 
sition in  the  character  will  cause  an  interrupt.  Of  course,  you  must  re-enable  the  PIO  in- 
terrupt after  the  entire  character  has  been  read. 
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Note  the  use  of  the  PIO  in  the  control  mode: 

1!    The  PIO  is  placed  In  the  control  mode  by  establishing  Mode  3. 

2)  The  next  control  word  defines  which  data  lines  are  to  be  inputs  CV)  and  which  are 
to  be  outputs  CO'). 

3)  The  interrupt  control  word  has,  besides  the  usual  enable  in  bit  7, 

bit  6  =  0  to  perform  a  logical  OR  of  the  monitored  data  lines  for  an  interrupt  (not 

used  in  this  case,  since  only  one  line  is  monitored) 
bit  5  =  0  to  define  the  active  polarity  of  the  data  lines  as  low  (for  the  start  bit  in  this 

case) 

bit  4  =  1  to  indicate  that  a  mask  word  follows. 

4)  The  next  control  word  contains  the  interrupt  masks.  Only  those  port  lines  with  a 
mask  bit  of  zero  will  be  monitored  for  generating  an  interrupt. 

The  net  result  is  for  an  interrupt  to  be  generated  if  bit  7  is  zero  or  changes  from  one  to 
zero.  Note  that  further  interrupts  occur  only  when  a  change  occurs  in  the  status  of  the 
logical  equation.  Here  again,  the  PIO  could  be  configured  by  using  a  table  and  the  re- 
peated block  output  instruction. 

MORE  GENERAL  SERVICE  ROUTINES 

More  general  service  routines  that  are  part  of  a  complete  inter- 
rupt-driven  system  must  handle  the  following  tasks: 


TASKS  FOR 
GENERAL  SERVICE 
ROUTINES 


1)  Saving  all  registers  that  are  used  in  the  interrupt  service 
routine  in  the  Stack  so  that  the  interrupted  program  can  be 
correctly  resumed. 

Remember  that  the  Z80  Push  instruction  transfers  a  register  pair  (or  an  index  register) 
to  the  Stack.  PUSH  AF  (F  is  the  Flag  register)  transfers  the  Accumulator  and  flags  to  the 
Stack. 

A  routine  to  save  all  the  registers  m  the  Stack  would  be: 


PUSH 

PUSH 

PUSH 

PUSH 

PUSH 

PUSH 

EX 

EXX 

PUSH 

PUSH 

PUSH 

PUSH 


AF 

BC 

DE 

HL 

IX 

lY 

AF.AF' 

AF 
BC 
DE 
HL 


SAVE  ACCUMULATOR.  FLAGS 
SAVE  REGISTERS  B.C 
SAVE  REGISTERS  D.E 
SAVE  REGISTERS  H,L 
SAVE  INDEX  REGISTER  IX 
SAVE  INDEX  REGISTER  lY 


SAVE  PRIMED  ACCUMULATOR,  FLAGS 
SAVE  PRIMED  REGISTERS  8,0 
SAVE  PRIMED  REGISTERS  D,E 
SAVE  PRIMED  REGISTERS  H,L 


Of  course,  only  those  registers  that  are  used  by  the  interrupt  service  routine  must  be 
saved. 

2)  Restoring  all  registers  from  the  Stack  after  completing  the  interrupt  service  routine. 
Remember  that  registers  must  be  restored  in  the  opposite  order  from  that  in  which 
they  were  saved. 

3)  Enabling  and  disabling  interrupts  appropriately.  Remember  that  the  CPU  automat- 
ically disables  its  interrupts  upon  accepting  one. 

The  service  routines  should  be  transparent  as  far  as  the  interrupted  program  is  con- 
cerned (i.e..  they  should  have  no  incidental  effects). 
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Any  standard  subroutines  that  are  used  by  an  interrupt  service  routine  must  be 
reentrant.  If  some  subroutines  cannot  be  made  reentrant,  the  interrupt  seryice  routine 
must  have  separate  versions  to  use.6 

PROBLEMS 

1}    A  Test  Interrupt 

Purpose:  The  computer  vi/aits  for  a  PIO  interrupt  to  occur,  then  executes  the  endless 
loop  instruction: 

HERE;      JR  HERE 

until  the  next  interrupt  occurs. 

2)  A  Keyboard  Interrupt 

Purpose:  The  computer  waits  for  a  4-digit  entry  from  a  keyboard  and  places  the  digits 
into  memory  locations  0040  through  0043  (first  one  received  in  0040).  Each 
digit  entry  causes  an  interrupt.  The  fourth  entry  should  also  result  in  the  dis- 
abling of  the  keyboard  interrupt. 

Sample  Problem: 

Keyboard  data  =  04,06,01.07 

Result:   (0040)  =  04 

(0041)  =  06 

(0042)  =  01 

(0043)  =  07 

3)  A  Printer  Interrupt 

Purpose:  The  computer  sends  four  characters  from  memory  locations  0040  to  0043 
(starting  with  0040)  to  the  printer.  Each  character  is  requested  by  an  inter- 
rupt. The  fourth  transfer  also  disables  the  printer  interrupt. 

4)  A  Real-Time  Clock  Interrupt 

Purpose:  The  computer  clears  memop/  location  0040  initially  and  then  complements 
memory  location  0040  each  time  the  real-time  clock  interrupt  occurs. 

How  would  you  change  the  program  so  that  it  complements  memory  location  0040 
after  every  ten  interrupts?  How  would  you  change  the  program  so  that  it  leaves  memo- 
ry location  0040  at  zero  for  ten  clock  periods.  FFi  g  for  five  clock  periods,  and  so  on  con- 
tinuously? You  may  want  to  use  a  display  rather  than  memory  location  0040  so  that  it 
will  be  easier  to  see. 

5)  A  Teletypewriter  Interrupt 

Purpose:  The  computer  receives  TTY  data  from  an  interrupting  SIO  and  stores  the 
characters  in  a  buffer  starting  in  memory  location  0040.  The  process  con- 
tinues until  the  computer  receives  a  carriage  return  {OD-\q). 

Assume  that  the  characters  are  7-bit  ASCII  with  odd  parity.  How  would  you  change 
your  program  to  use  a  PIO?  Assume  that  subroutine  TTYRCV  is  available,  as  in  the  ex- 
ample. Include  the  carriage  return  as  the  final  character  in  the  buffer. 
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Chapter  13 
PROBLEM  DEFINITION  AND 
PROGRAM  DESIGN 


THE  TASKS  OF  SOFTWARE  DEVELOPMENT 

In  the  previous  chapters,  we  have  concentrated  on  the  writing  of  short  programs  in  as- 
sembly language.  While  this  is  an  important  topic,  it  is  only  a  small  part  of  software 
development.  Although  writing  assembly  language  programs  is  a  ma]or  task  for  the 
beginner,  it  soon  becomes  simple.  By  now,  you  should  be  familiar  with  standard 
methods  for  programming  in  assembly  language  on  the  Z80  microprocessor.  The  next 
four  chapters  will  describe  how  to  formulate  tasks  as  programs  and  how  to  com- 
bine short  programs  to  form  a  working  system. 

Software  development  consists  of  many  stages.  Figure 
13-1  is  a  flowchart  of  the  software  development  process.  Its 
stages  are: 

•  Problem  definition 

•  Program  design 

•  Coding 

•  Debugging 

•  Testing 

•  Documentation 

•  Maintenance  and  redesign 

Each  of  these  stages  is  important  in  the  construction  of  a  working  system.  Note  that 
coding,  the  writing  of  programs  in  a  form  that  the  computer  understands,  is  only  one  of 
seven  stages. 

In  fact,  coding  is  usually  the  easiest  stage  to  define  and  per- 
form. The  rules  for  writing  computer  programs  are  easy  to  learn. 
They  vary  somewhat  from  computer  to  computer,  but  the  basic 
techniques  remain  the  same.  Few  software  projects  run  into  trou- 
ble because  of  coding;  indeed,  coding  is  not  the  most  time-consuming  part  of  software 
development.  Experts  estimate  that  a  programmer  can  wnte  one  to  ten  fully  debugged 
and  documented  statements  per  day.  Clearly,  the  mere  coding  of  one  to  ten  statements 
is  hardly  a  full  day's  effort.  On  most  software  projects,  coding  occupies  less  than  25%  of 
the  programmer's  time. 

Measuring  progress  in  the  other  stages  is  difficult.  You  can  say 

that  half  of  the  program  has  been  written,  but  you  can  hardly  say 
that  half  of  the  errors  have  been  removed  or  half  of  the  problem 
has  been  defined.  Timetables  for  such  stages  as  program  design, 
debugging,  and  testing  are  difficult  to  produce.  Many  days  or  weeks  of  effort  may  result 
in  no  clear  progress.  Furthermore,  an  incomplete  job  in  one  stage  may  result  in  tremen- 
dous problems  later.  For  example,  poor  problem  definition  or  program  design  can  make 
debugging  and  testing  very  difficult.  Time  saved  in  one  stage  may  be  spent  many  times 
over  m  later  stages. 


STAGES  OF 
SOFTWARE 
DEVELOPMENT 


RELATIVE 
IMPORTANCE 
OF  CODING 


MEASURING 
PROGRESS 
IN  STAGES 
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PROBLEM 
DEFINITION 


DEFINITION  OF  THE  STAGES 

Problem  definition  is  the  formulation  of  the  task  in  terms  of 
the  requirements  that  it  places  on  the  computer.  For  example, 
what  is  necessary  to  make  a  computer  control  a  tool,  run  a  series 
of  electrical  tests,  or  handle  communications  between  a  central  controller  and  a  remote 
instrument?  Problem  definition  requires  that  you  determine  the  forms  and  rates  of  in- 
puts and  outputs,  the  amount  and  speed  of  processing  that  is  needed,  and  the  types  of 
possible  errors  and  their  handling.  Problem  definition  takes  a  vague  idea  of  building  a 
computer-controlled  system  and  defines  the  tasks  and  requirements  for  the  computer. 

Program  design  is  the  outline  of  the  computer  program  which 
will  perform  the  tasks  that  have  been  defined.  In  the  design 
stage,  the  tasks  are  described  in  a  way  that  can  easily  be  con- 
verted into  a  program.  Among  the  useful  techniques  in  this  stage  are  flowcharting, 
structured  programming,  modular  programming,  and  top-down  design. 


PROGRAM 
DESIGN 


Coding  is  the  writing  of  the  program  in  a  form  that  the  com-  |  CODING  | 

puter  can  either  directly  understand  or  translate.  The  form  may 
be  machine  language,  assembly  language,  or  a  high-level  language. 

Debugging,  also  called  program  verification,  is  making  the  pro-  |DEBUGGING[ 
gram  do  what  the  design  specified  that  it  would  do.  In  this 
stage,  you  use  such  tools  as  breakpoints,  traces,  simulators,  logic  analyzers,  and  in-oir- 
cuit  emulators.  The  end  of  the  debugging  stage  is  hard  to  define,  since  you  never  know 
when  you  have  found  the  last  error. 

Testing,  also  referred  to  as  program  validation,  is  ensuring  that  | TESTING] 

the  program  performs  the  overall  system  tasks  correctly.  The 

designer  uses  simulators,  exercisers,  and  various  statistical  techniques  to  get  some 
measure  of  the  program's  performance. 

Documentation  is  the  description  of  the  program  in  the  |  DOCUMENTATION! 
proper  form  for  users  and  maintenance  personnel.  Docu- 
mentation also  allows  the  designer  to  develop  a  program  library  so  that  subsequent 
tasks  will  be  far  simpler.  Flowcharts,  comments,  memory  maps,  and  library  forms  are 
some  of  the  tools  used  in  documentation. 


Maintenance  and  redesign  are  the  servicing,  improvement,  MAINTENANCE 
and  extension  of  the  program.  Clearly,  the  designer  must  be  AND 
ready  to  handle  field  problems  in  computer-based  equipment.  REDESIGN 
Special  diagnostic  modes  or  programs  and  other  maintenance 

tools  may  be  required.  Upgrading  or  extension  of  the  program  may  be  necessary  to 
meet  new  requirements  or  handle  new  tasks. 

The  rest  of  this  chapter  will  consider  only  the  problem  definition  and  program 
design  stages.  Chapter  14  will  discuss  debugging  and  testing,  and  Chapter  15  will  dis- 
cuss documentation,  extension,  and  redesign.  We  will  bring  all  the  stages  together  in 
some  simple  systems  examples  in  Chapter  16. 

PROBLEM  DEFINITION 

Typical  microprocessor  tasks  require  a  lot  of  definition.  For  example,  what  must  a  pro- 
gram do  to  control  a  scale,  a  cash  register,  or  a  signal  generator?  Clearly,  we  have  a 
long  way  to  go  just  to  define  the  tasks  involved. 
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DEFINING  THE  INPUTS 

How  do  we  start  the  definition?  The  obvious  place  to  begin  is  with  the  Inputs.  We 
should  begin  by  listing  all  the  inputs  that  the  computer  may  receive  in  this  applica- 
tion. 

Examples  of  inputs  are: 

■  Data  blocks  from  transmission  lines 

•  Status  words  from  peripherals 

•  Data  from  A/D  converters 
Than,  we  may  ask  the  following  questions  about  each  input: 

1)  What  is  Its  form;  i.e.,  what  signals  will  the  computer  actuallv 
receive? 

2)  When  is  the  input  available  and  how  does  the  processor  know  it  is  available?  Does 
the  processor  have  to  request  the  input  with  a  strobe  signal?  Does  the  input  pro- 
vide Its  own  clock? 

3)  How  long  is  it  available? 

4)  How  often  does  it  change,  and  how  does  the  processor  know  that  it  has  changed? 

5)  Does  the  input  consist  of  a  sequence  or  block  of  data?  Is  the  order  important? 

6)  What  should  be  done  if  the  data  contains  errors?  These  may  include  transmission 
errors,  incorrect  data,  sequencing  errors,  extra  data,  etc. 

7)  Is  the  input  related  to  other  inputs  or  outputs? 
DEFINING  THE  OUTPUTS 

The  next  step  to  define  is  the  output.  We  must  list  all  the  outputs  that  the  computer 

must  produce.  Examples  of  outputs  include: 

•  Data  blocks  to  transmission  lines 

■  Control  words  to  penpherals 

•  Data  to  D/A  converters 

Then,  we  may  ask  the  following  questions  about  each  output:  ' 

1)  What  IS  Its  form:  i.e..  what  signals  must  the  computer  produce? 

2)  When  must  it  be  available,  and  how  does  the  peripheral  know  it  is  available? 

3)  How  long  must  it  be  available? 

4)  How  often  must  it  change,  and  how  does  the  peripheral  know  that  it  has  changed? 

5)  Is  there  a  sequence  of  outputs?  Is  the  order  important? 

6)  What  should  be  done  to  avoid  transmission  errors  or  to  sense  and  recover  from  pe- 
ripheral failures? 

'7)    How  is  the  output  related  to  other  inputs  and  outputs? 


FACTORS 
IN  INPUT 
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PROCESSING  SECTION 

Between  the  reading  of  input  data  and  the  sending  of  output  results  Is  the  processing 
section.  Here  we  must  determine  exactly  how  the  computer  must  process  the  in- 
put data.  The  questions  are: 

1)  What  IS  the  basic  procedure  (algorithm)  for  transforming  input 
data  into  output  results? 

2)  What  time  constraints  exist?  These  may  include  data  rates, 
delay  times,  the  time  constants  of  input  and  output  devices,  etc. 

3)  What  memory  constraints  exist?  Do  we  have  limits  on  the  amount  of  program 
memory  or  data  memory,  or  on  the  size  of  buffers? 

4)  What  standard  programs  or  tables  must  be  used?  What  are  their  requirements? 

5)  What  special  oases  exist,  and  how  should  the  program  handle  them? 

6)  How  accurate  must  the  results  be? 

7)  How  should  the  program  handle  processing  errors  or  special  conditions  such  as 
overflow,  underflow,  or  loss  of  significance? 

ERROR  HANDLING 

An  important  factqp-  in  many  applications  is  the  handling  of  errors.  Clearly,  the 
designer  must  make  provisions  for  recovering  from  common  errors  and  for  diagnosing 
malfunctions.  Among  the  questions  that  the  designer  must  ask  at  the  definition 
stage  are: 

1)  What  errors  could  occur? 

2)  Which  errors  are  most  likely?  If  a  person  operates  the 
system,  human  error  is  the  most  common.  Following 
human  errors,  communications  or  transmission  errors  are  more  common  than 
mechanical,  electrical,  mathematical,  or  processor  errors. 

3!    Which  errors  will  not  be  Immediately  obvious  to  the  system?  A  special  problem  is 
the  occurrence  of  errors  that  the  system  or  operator  may  not  recognize  as  incorrect. 

4)  How  can  the  system  recover  from  errors  with  a  minimum  loss  of  time  and  data  and 
vet  be  aware  that  an  error  has  occurred? 

5)  Which  errors  or  malfunctions  cause  the  same  system  behavior?  How  can  these  er- 
rors or  malfunctions  be  distinguished  for  diagnostic  purposes? 

6!    Which  errors  involve  special  system  procedures?  For  example,  do  parity  errors  re- 
quire retransmission  of  data? 

Another  question  is:  How  can  the  field  technician  systematically  find  the  source  of 
malfunctions  without  being  an  expert?  Built-in  test  programs,  special  diagnostics,  or 
signature  analysis  can  help.^ 


FACTORS  IN 
PROCESSING 


ERROR 

CONSIDERATIONS 
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HUMAN  FACTORS 

Many  microprocessor-based  systems  involve  human  interaction.  OPERATOR 
Human  factors  must  be  considered  throughout  the  develop-  INTERACTION 
ment  process  for  such  systems.  Among  the  questions  that  the 
designer  must  ask  are: 

1)  What  input  procedures  are  most  natural  for  the  human  operator? 

2)  Can  the  operator  easily  determine  how  to  begin,  continue  and  end  the  input 
operations? 

3)  How  IS  the  operator  informed  of  procedural  errors  and  equipment  malfunctions? 

4)  What  errors  is  the  operator  most  likely  to  make? 

5)  How  does  the  operator  know  that  data  has  been  entered  correctly' 

6)  Are  displays  in  a  form  that  the  operator  can  easily  read  and  understand? 

7)  Is  the  response  of  the  system  adequate  for  the  operator? 

8)  Is  the  system  easy  for  the  operator  to  use? 

9)  Are  there  guiding  features  for  an  inexperienced  operator? 

10)  Are  there  shortcuts  and  reasonable  options  for  the  experienced  operator? 

11)  Can  the  operator  always  determine  or  reset  the  state  of  the  system  after  interrup- 
tions or  distractions? 

Building  a  system  for  people  to  use  is  difficult.  The  microprocessor  can  make  the 
system  more  powerful,  more  flexible,  and  more  responsive.  However,  the  designer  still 
must  add  the  human  touches  that  can  greatly  increase  the  usefulness  and  attractive- 
ness of  the  system  and  the  productivity  of  the  human  operator.^ 

EXAMPLES 

Response  to  a  Switch 

Figure  1 3-2  shows  a  simple  system  in  which  the  input  is  from 


DEFINING 
SWITCH  AND 
LIGHT 
SYSTEM 


SWITCH  AND 
LIGHT  INPUT 


a  single  SPST  switch  and  the  output  is  to  a  single  LED  display. 
In  response  to  a  switch  closure,  the  processor  turns  the  dis- 
play on  for  one  second.  This  system  should  be  easy  to  define. 

Let  us  first  examine  the  input  and  answer  each  of  the  questions 
previously  presented: 

1)  The  input  is  a  single  bit,  which  may  be  either  '0'  (switch 
closed)  or  '1'  {switch  open). 

2)  The  input  is  always  available  and  need  not  be  requested. 

3)  The  input  is  available  for  at  least  several  milliseconds  after  the  closure. 

4)  The  input  will  seldom  change  more  than  once  every  few  seconds.  The  processor 
has  to  handle  only  the  bounce  in  the  switch.  The  processor  must  monitor  the 
switch  to  determine  when  it  is  closed. 

5)  There  is  no  sequence  of  inputs. 

6)  The  obvious  input  errors  are  switch  failure,  failure  in  the  input  circuitr/,  and  the 
operator  attempting  to  close  the  switch  again  before  a  sufficient  amount  of  time 
has  elapsed.  We  will  discuss  the  handling  of  these  errors  later. 

7)  The  input  does  not  depend  on  any  other  inputs  or  outputs. 
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The  switch  input  is  a  'V  if  the  switch  is  open,  '0'  if  the 
switch  iS  closed.  The  CPU  applies  the  output  to  the 
cathode  of  the  LED:  a  '0'  lights  the  display. 


Figure  13-2.  The  Switch  and  Light  System 

The  next  requirement  in  defining  the  system  is  to  examine  the 
output.  The  answers  to  our  questions  are: 


The  output  is  a  single  bit,  which  is  '0'  to  turn  the  display  on, 
'1'  to  turn  it  off. 


SWITCH 
AND  LIGHT 
OUTPUTS 


There  are  no  time  constraints  on  the  output.  The  peripheral  does  not  need  to  be  in- 
formed of  the  availability  of  data. 

If  the  display  is  an  LED,  the  data  need  be  available  for  only  a  few  milliseconds  at  a 
pulse  rate  of  about  100  times  per  second.  The  observer  will  see  a  continuously  lit 
display. 

4)  The  data  must  change  (go  off)  after  one  second. 

5)  There  is  no  sequence  of  outputs. 

6)  The  possible  output  errors  are  display  failure  and  failure  in  the  output  circuitry. 

7)  The  output  depends  only  on  the  switch  input  and  time. 

The  processing  section  is  extremely  simple.  As  soon  as  the  switch  input  becomes 
a  logic  '0',  the  CPU  turns  the  light  on  (a  logic  '0')  for  one  second.  No  time  or  memo- 
ry constraints  exist. 


SWITCH  AND 
LIGHT  ERROR 
HANDLING 


Let  us  now  look  at  the  possible  errors  and  malfunctions.  These 
are: 

•  Another  switch  closure  before  one  second  has  elapsed 

•  Switch  failure 

•  Display  failure 

•  Computer  failure 

Surely  the  first  error  is  the  most  likely.  The  simplest  solution  is  for  the  processor  to  ig- 
nore switch  closures  until  one  second  has  elapsed.  This  brief  unresponsive  period  will 
hardly  be  noticeable  to  the  human  operator.  Furthermore,  ignoring  the  switch  dunng 
this  period  means  that  no  debouncing  circuitry  or  software  is  necessary,  since  the 
system  will  not  react  to  the  bounce  anyway. 
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Clearly,  the  last  three  failures  can  produce  unpredictable  results.  The  display  may  stay 
on.  stay  off.  or  change  state  randonnly.  Some  possible  ways  to  isolate  the  failures  would 
be: 

•  Lamp-test  hardware  to  check  the  display:  i.e.,  a  button  that  turns  the  light  on 
independently  of  the  processor 

•  A  direct  connection  to  the  switch  to  check  its  operation 

•  A  diagnostic  program  that  exercises  the  input  and  output  circuits 

If  both  the  display  and  switch  are  working,  the  computer  is  at  fault.  .A  field  technician 
with  proper  equipment  can  determine  the  cause  of  the  failure. 

A  Switch-Based  Memory  Loader 

Figure  1 3-3  shows  a  system  that  allows  the  user  to  enter 
data  into  any  memory  location  in  a  microcomputer.  One  in- 
put port,  DPORT,  reads  data  from  eight  toggle  switches. 
The  other  input  port,  CPORT,  is  used  to  read  control  infor- 
mation. There  are  three  momentary  switches:  High  Address,  Low  Address  and 
Data.  The  output  is  the  value  of  the  last  completed  entry  from  the  data  switches; 
eight  LEDs  are  used  for  the  display. 

The  system  will  also,  of  course,  require  various  resistors,  buffers,  and  drivers. 

We  shall  first  examine  the  inputs.  The  characteristics  of  the  switches  are  the  same  as 
in  the  previous  example:  however,  here  there  is  a  distinct  sequence  of  inputs,  as 
follows: 

1)  The  operator  must  set  the  data  switches  according  to  the  eight  most  significant 
bits  of  an  address,  then 

2)  press  the  High  Address  button.  The  high  address  bits  will  appear  on  the  lights,  and 
the  program  will  interpret  the  data  as  the  high  byte  of  the  address. 

3)  Then  the  operator  must  set  the  data  switches  with  the  value  of  the  least  significant 
byte  of  the  address  and 

4!    press  the  Low  Address  button.  The  low  address  bits  will  appear  on  the  lights,  and 
the  program  will  consider  the  data  to  be  the  low  byte  of  the  address. 

5)  Finally,  the  operator  must  set  the  desired  data  into  the  data  switches  and 

6)  press  the  Data  button.  The  display  will  now  show  the  data,  and  the  program  stores 
the  data  m  memory  at  the  previously  entered  address. 

The  operator  may  repeat  the  process  to  enter  an  entire  program.  Clearly,  even  in  this 
simplified  situation,  we  will  have  many  possible  sequences  to  consider.  How  do  we 
cope  with  erroneous  sequences  and  make  the  system  easy  to  use? 

Output  is  no  problem.  After  each  input,  the  program  sends  to  the  displays  the 
complement  (since  the  displays  are  active-low)  of  the  input  bits.  The  output  data 
remains  the  same  until  the  next  input  operation. 

The  processing  section  remains  quite  simple.  There  are  no  time  or  memory  con- 
straints. The  program  can  debounce  the  switches  by  waiting  for  a  few  milliseconds,  and 
must  provide  complemented  data  to  the  displays. 
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Figure  13-3.  The  Switch-Based  Memory  Loader 
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The  most  likely  errors  are  operator  mistakes.  These  Include: 

•  Incorrect  entries 

•  Incorrect  order 

•  Incomplete  entries;  for  example,  forgetting  tfie  data 

The  system  must  be  able  to  handle  these  problems  in  a  reasonable 
way,  since  they  are  certain  to  occur  in  actual  operation. 

The  designer  must  also  consider  the  effects  of  equipment  failure.  Just  as  before, 
the  possible  difficulties  are: 

•  Switch  failure 

•  Display  failure 

•  Computer  failure 

In  this  system,  however,  we  must  pay  more  attention  to  how  these  failures  affect  the 
system.  A  computer  failure  will  presumably  cause  very  unusual  behavior  by  the  system, 
and  will  be  easy  to  detect.  A  display  failure  may  not  be  immediately  noticeable;  here  a 
Lamp  Test  feature  will  allow  the  operator  to  check  the  operation.  Note  that  we  would 
like  to  test  each  LED  separately,  in  order  to  diagnose  the  case  in  which  output  lines  are 
shorted  togethet  In  addition,  the  operator  may  not  immediately  detect  switch  failure; 
however,  the  operator  should  soon  notice  it  and  establish  which  switch  is  faulty  by  a 
process  of  elimination. 

Let  us  look  at  some  of  the  possible  operator  errors.  Typical  errors 
will  be: 

•  Erroneous  data 

•  Wrong  order  of  entries  or  switches 

•  Trying  to  go  on  to  the  next  entry  without  completing  the  current 
one 

The  operator  will  presumably  notice  erroneous  data  as  soon  as  it  appears  on  the  dis- 
plays. What  IS  a  viable  recovery  procedure  for  the  operator?  Some  of  the  options  are: 

1)  The  operator  must  complete  the  entry  procedure;  i.e..  enter  Low  Address  and  Data 
if  the  error  occurs  in  the  High  Address.  Clearly,  this  procedure  is  wasteful  and 
would  only  serve  to  annoy  the  operator. 

2)  The  operator  may  restart  the  entry  process  by  returning  to  the  high  address  entry 
steps.  This  solution  is  useful  if  the  error  was  in  the  High  Address,  but  forces  the 
operator  to  re-enter  earlier  data  if  the  error  was  in  the  Low  Address  or  Data  stage. 

3)  The  operator  may  enter  any  part  of  the  sequence  at  any  time  simply  by  setting  the 
Data  switches  with  the  desired  data  and  pressing  the  corresponding  button.  This 
procedure  allows  the  operator  to  make  corrections  at  any  point  in  the  sequence. 

This  type  of  procedure  should  always  be  preferred  over  one  that  does  not  allow  immedi- 
ate error  correction,  has  a  variety  of  concluding  steps,  or  enters  data  into  the  system 
without  allowing  the  operator  a  final  check.  Any  added  complication  in  hardware  or 
software  will  be  justified  in  increased  operator  efficiency.  You  should  always  prefer  to 
let  the  microcomputer  do  the  tedious  work  and  recognize  arbitrary  sequences;  it  never 
gets  tired  and  never  forgets  what  was  in  the  operating  manual. 

A  further  helpful  feature  would  be  status  lights  that  would  define  the  meaning  of  the 
display.  Three  status  lights,  marked  "High  Address",  "Low  Address",  and  "Data", 
wou  Id  let  the  operator  know  what  had  been  entered  without  having  to  remember  which 
button  was  pressed.  The  processor  would  have  to  monitor  the  sequence,  but  the  added 
complication  in  software  would  simplify  the  operator's  task.  Clearly,  three  separate  sets 
of  displays  plus  the  ability  to  examine  a  memory  location  would  be  even  more  helpful  to 
the  operator. 
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Figure  13-4.  Block  Diagram  of  a  Verification  Terminal 

We  should  note  that,  although  we  have  emphasized  human  interaction,  machine 
or  system  interaction  has  many  of  the  same  characteristics.  The  microprocessor 
should  do  the  work,  if  complicating  the  microprocessor's  tasl<  makes  error  recov- 
ery simple  and  the  causes  of  failure  obvious,  the  entire  system  will  work  better 
and  be  easier  to  maintain.  Note  that  vou  should  not  wait  until  after  the  software  has 
been  completed  to  consider  system  use  and  maintenance:  instead,  vou  should  include 
these  factors  in  the  problem  definition  stage. 

A  Verification  Terminal 


Figure  13-4  is  a  block  diagram  of  a  simple  credit-verification     DEFINING  A 
terminal.  One  input  port  derives  data  from  a  keyboard  (see  VERIFICATION 
Figure  13-5);  the  other  input  port  accepts  verification  data  TERMINAL 
from  a  transmission  line.  One  output  port  sends  data  to  a  set  of 
displays  (sea  Figure  13-6);  another  sends  the  credit  card  number  to  the  central 
computer.  A  third  output  port  turns  on  one  light  whenever  the  terminal  is  ready  to 
accept  an  inquiry,  and  another  light  when  the  operator  sends  the  information.  The 
"Busy"  light  turns  off  when  the  response  returns.  Clearly,  the  input  and  output  of 
data  will  be  more  complex  than  in  the  previous  case,  although  the  processing  is  still 
simple. 


13-11 


7  8  9 


4  5  6  CLEAR 


2  3  SEND 


0 


The  digit  keys  allow  digit  entnes. 

CLEAR  dsletes  the  entire  entry. 

SEND  transmits  the  entry  to  the  central  computer. 


Figure  13-5.  Verification  Terminai  Keyboard 
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The  display  consists  of  ten  7-segment  displays,  which  may  be  muitipfexed.  controiied  bv  a  shift 
register,  or  addressed  separately.  Two  additional  lights,  READY  end  BUSY,  are  also  present. 

Figure  13-6.  Verification  Terminal  Display 
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Additional  displays  may  be  useful  to  emphasize  the  meaning  of  the  response.  Many  ter- 
minals use  a  green  light  for  "Yes",  a  red  light  for  "No",  and  a  yellow  light  for  "Consult 
Store  Manager."  Note  that  these  lights  will  still  have  to  be  clearly  marked  with  their 
meanings  to  allow  for  a  color-blind  operator. 

Let  us  first  look  at  the  keyboard  input.  This  is,  of  course, 
different  from  the  switch  input,  since  the  CPU  must  have  some 
way  of  distinguishing  new  data.  We  will  assume  that  each  key 
closure  provides  a  unique  hexadecimal  code  (we  can  code 
each  of  the  1 2  keys  into  one  digit)  and  a  strobe.  The  program  will  have  to  recogn- 
ize the  strobe  and  fetch  the  hexadecimal  number  that  identifies  the  key.  There  is  a 
time  constraint,  since  the  program  cannot  miss  any  data  or  strobes.  The  constraint  is 
not  serious,  since  keyboard  entries  will  be  at  least  several  milliseconds  apart. 

The  transmission  input  similarly  consists  of  a  series  of  characters,  each  identified 
by  a  strobe  (perhaps  from  a  UART).  The  program  will  have  to  recognize  each 
strobe  and  fetch  the  character.  The  data  being  sent  across  the  transmission  lines 
is  usually  organized  into  messages.  A  possible  message  format  is: 

•  Introductory  characters,  or  header 

•  Terminal  destination  address 

•  Coded  yes  or  no 

•  Ending  characters,  or  trailer 

The  terminal  will  check  the  header,  read  the  destination  address,  and  see  if  the 
message  is  intended  for  it.  If  the  message  is  for  the  terminal,  the  terminal  accepts  the 
data.  The  address  could  be  (and  often  is)  hard-wired  into  the  terminal  so  that  the  ter- 
minal receives  only  messages  intended  for  it.  This  approach  simplifies  the  software  at 
the  cost  of  some  flexibility. 

The  output  is  also  more  complex  than  in  the  earlier  examples. 
If  the  displays  are  multiplexed,  the  processor  must  not  only 
send  the  data  to  the  display  port  but  must  also  direct  the  data 
to  a  particular  display.  We  will  need  either  a  separate  control  port 
or  a  counter  and  decoder  to  handle  this.  Note  that  hardware  blanking  controls  can 
blank  leading  zeros  as  long  as  the  first  digit  in  a  multi-digit  number  is  never  zero.  Soft- 
ware can  also  handle  this  task.  Time  constraints  include  the  pulse  length  and  frequency 
required  to  produce  a  continuous  display  for  the  operator. 

The  communications  output  will  consist  of  a  series  of  characters  with  a  particular 
format.  The  program  will  also  have  to  consider  the  time  required  between  charac- 
ters. A  possible  format  for  the  output  message  is: 

•  Header 

•  Terminal  address 

•  Credit  card  number 

•  Trailer 

A  central  communications  computer  may  poll  the  terminals,  checking  for  data 
ready  to  be  sent. 

The  processing  in  this  system  involves  many  new  tasks,  such  as: 

•  Identifying  the  control  keys  by  number  and  performing  the  proper  actions 

•  Adding  the  header,  terminal  address,  and  trailer  to  the  outgoing  message 

•  Recognizing  the  header  and  trailer  in  the  returning  message 

•  Checking  the  Incoming  terminal  address 
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Note  that  none  of  the  tasks  involve  any  complex  arithnnetic  or  any 
serious  time  or  memory  constraints. 

The  number  of  possible  errors  in  this  system  is,  of  course, 
much  larger  than  in  the  earlier  examples.  Let  us  first  consider 
the  possible  operator  errors.  These  include: 

•  Entering  the  credit  card  number  incorrectly 
■  Trying  to  send  an  incomplete  credit  card  number 

•  Trying  to  send  another  number  while  the  central  computer  is  processing  one 

•  Clearing  non-existent  entries 

Some  of  these  errors  can  be  easily  handled  by  correctly  structunng  the  program.  For  ex- 
ample, the  program  should  not  accept  the  Send  key  until  the  credit  card  number  has 
been  completely  entered,  and  it  should  ignore  any  additional  keyboard  entries  until  the 
response  comes  back  from  the  central  computer.  Note  that  the  operator  will  know  that 
the  entry  has  not  been  sent,  since  the  Busy  light  will  not  go  on.  The  operator  will  also 
know  when  the  keyboard  has  been  locked  out  (the  program  is  ignoring  keyboard  en- 
tries), since  entries  will  not  appear  on  the  display  and  the  Ready  light  will  be  off. 

Incorrect  entries  are  an  obvious  problem.  If  the  operator  recog-  CORRECTING 
nizes  an  error,  he  can  use  the  Clear  key  to  make  corrections.  The  KEYBOARD 
operator  would  probably  find  it  more  convenient  to  have  two  Clear  ERRORS 
keys,  one  that  cleared  the  most  recent  key  and  one  that  cleared 
the  entire  entry.  This  would  allow  both  for  the  situation  in  which  the  operator  recog- 
nizes the  error  immediately  and  for  the  situation  in  which  the  operator  recognizes  the 
error  late  in  the  procedure.  The  operator  should  be  able  to  correct  errors  immediately 
and  have  to  repeat  as  few  keys  as  possible.  The  operator  will,  however,  make  a  certain 
number  of  errors  without  recognizing  them.  Most  credit  card  numbers  include  a  self- 
checking  digit:  the  terminal  could  check  the  number  before  permitting  it  to  be  sent  to 
the  central  computer.  This  step  wou  Id  save  the  central  computer  from  wasting  precious 
processing  time  checking  the  number. 

This  requires,  however,  that  the  terminal  have  some  way  of  informing  the  operator  of 
the  error,  perhaps  by  flashing  one  of  the  displays  or  by  providing  some  other  special  in- 
dicator that  the  operator  is  sure  to  notice. 

Still  another  problem  is  how  the  operator  knows  that  an  entry  has  been  lost  or  pro- 
cessed incorrectly.  Some  terminals  simply  unlock  after  a  maximum  time  delay.  The 
operator  notes  that  the  Busy  light  has  gone  off  without  an  answer  being  received.  The 
operator  is  then  expected  to  try  the  entry  again.  .After  one  or  two  retries,  the  operator 
should  report  the  failure  to  supervisory  personnel. 

Many  equipment  failures  are  also  possible.  Besides  the  displays,  keyboard,  and 
processor,  there  now  exist  the  problems  of  communications  errors  or  failures  and 
central  computer  failures. 
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The  data  transmission  will  probably  liave  to  include  error  checking  and  correcting  pro- 
cedures. Some  possibilities  are: 

1)  Parity  provides  an  error  detection  facility  but  no  correction 
mechanism.  The  receiver  will  need  some  way  of  request- 
ing retransmission,  and  the  sender  will  have  to  save  a  copy 
of  the  data  until  proper  reception  is  acknowledged.  Parity 
is,  however,  very  simple  to  implement. 

2)  Short  messages  may  use  more  elaborate  schemes.  For  example,  the  yes/no 
response  to  the  terminal  could  be  coded  so  as  to  provide  error  detection  and  cor- 
rection capability. 

3)  An  acknowledgement  and  a  limited  number  of  retries  could  trigger  an  indicator 
that  would  inform  the  operator  of  a  communications  failure  (inability  to  transfer  a 
message  without  errors)  or  central  computer  failure  (no  response  at  all  to  the 
message  within  a  certain  period  of  time).  Such  a  scheme,  along  with  the  Lamp 
Test,  would  allow  simple  failure  diagnosis. 

A  communications  or  central  computer  failure  indicator  should  also  "unlock"  the  ter- 
minal, i.e.,  allow  it  to  accept  another  entry.  This  is  necessary  if  the  terminal  will  not  ac- 
cept entries  while  a  verification  is  in  progress.  The  terminal  mav  also  unlock  after  a  cer- 
tain maximum  time  delay.  Certain  entries  could  be  reserved  for  diagnostics;  i.e..  certain 
credit  card  numbers  could  be  used  to  check  the  internal  operation  of  the  terminal  and 
test  the  displays. 

REVIEW  OF  PROBLEM  DEFINITION 

Problem  definition  is  as  important  a  part  of  software  development  as  it  is  of  any 
other  engineering  task.  Note  that  it  does  not  require  any  programming  or 
knowledge  of  the  computer;  rather,  it  is  based  on  an  understanding  of  the  system 
and  sound  engineering  judgment.  Microprocessors  can  offer  flexibility  that  the 
designer  can  use  to  provide  a  range  of  features  which  were  not  previously  availa- 
ble. 

Problem  definition  is  independent  of  any  particular  computer,  computer  language, 
or  development  system.  It  should,  however,  provide  guidelines  as  to  what  type  or 
speed  of  computer  the  application  will  require  and  what  kind  of  hard- 
ware/software trade-offs  the  designer  can  make.  The  problem  definition  stage  is 
in  fact  independent  of  whether  or  not  a  computer  is  used  at  all,  although  a 
knowledge  of  the  capabilities  of  the  computer  can  help  the  designer  in  suggesting 
possible  implementations  of  procedures. 
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PROGRAM  DESIGN 


Program  design  is  tlie  stage  in  which  the  problem  definition  is  formulated  as  a  pro- 
gram. If  the  program  is  small  and  simple,  this  stage  may  involve  little  more  than 
the  writing  of  a  one-page  flowchart.  If  the  program  is  larger  or  more  complex,  the 
designer  should  consider  more  elaborate  methods 

We  will  discuss  flowcharting,  modular  programming,  structured  programming,  and 
top-down  design.  We  will  try  to  indicate  the  reasoning  behind  these  methods,  and 
their  advantages  and  disadvantages.  We  will  not,  however,  advocate  any  particular 
method  since  there  is  no  evidence  that  one  method  is  always  superior  to  all  others.  You 
should  remember  that  the  goal  is  to  produce  a  good  working  system,  not  to  follow 
religiously  the  tenets  of  one  methodology  or  another. 

All  the  methodologies  do,  however,  have  some  obvious  princi- 
ples in  common.  Many  of  these  are  the  same  principles  that  apply 
to  any  kind  of  design,  such  as: 

1)  Proceed  in  small  steps.  Do  not  try  to  do  too  much  at  one 
time. 

2)  Divide  large  jobs  into  small,  logically  separate  tasks.  Make  the  sub-tasks  as  inde- 
pendent of  one  another  as  possible,  so  that  they  can  be  tested  separately  and  so 
that  changes  can  be  made  in  one  without  affecting  the  others. 

3)  Keep  the  flow  of  control  as  simple  as  possible  so  as  to  make  it  easier  to  find  errors. 

4)  Use  pictorial  or  graphic  descriptions  as  much  as  possible.  They  are  easier  to 
visualize  than  word  descriptions.  This  is  the  great  advantage  of  flowcharts. 

5)  Emphasize  clarity  and  simplicity  at  first.  You  can  improve  performance  (if  necess- 
ary) once  the  system  is  working. 

6)  Proceed  in  a  thorough  and  systematic  manner.  Use  checklists  and  standard  pro- 
cedures. 

7)  Do  not  tempt  fate.  Either  do  not  use  methods  that  you  are  not  sure  of,  or  use  them 
very  carefully.  Watch  for  situations  that  might  cause  confusion,  and  clarify  them 
as  soon  as  possible. 

8)  Keep  in  mind  that  the  system  must  be  debugged,  tested  and  maintained.  Plan  for 
these  later  stages. 

9j  Use  simple  and  consistent  terminology  and  methods.  Repetitiveness  is  no  fault  in 
program  design,  nor  is  complexity  a  virtue. 

10)  Have  your  design  completeiy  formulated  before  you  start  coding.  Resist  the 
temptation  to  start  writing  down  instructions;  it  makes  no  more  sense  than  mak- 
ing parts  lists  or  laying  out  circuit  boards  before  vou  know  exactly  what  will  be  in 
the  system. 

11)  Be  particularly  careful  of  factors  that  may  change.  Make  the  implementation  of 
likely  changes  as  simple  as  possible. 
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Figure  13-7,  Standard  Flowchart  Symbols 
FLOWCHARTING 

Flowcharting  is  certainly  the  best-known  of  all  program  design  methods.  Programming 
textbooks  describe  how  programmers  first  write  complete  flowcharts  and  then  start 
writing  the  actual  program.  In  fact,  few  programmers  have  ever  worked  this  way,  and 
flowcharting  has  often  been  more  of  a  |oke  or  a  nuisance  to  programmers  than  a  design 
method.  We  will  try  to  describe  both  the  advantages  and  disadvantages  of  flowcharts, 
and  show  the  place  of  this  technique  in  program  design. 

The  basic  advantage  of  the  flowchart  is  that  it  is  a  pictorial 
representation.  People  find  such  representations  much  more 
meaningfuLthan  written  descriptions.  The  designer  can  visual- 
ize the  whole  system  and  see  the  relationships  of  the  various  parts.  Logical  errors  and 
inconsistencies  often  stand  out  instead  of  being  hidden  in  a  printed  page.  At  its  best, 
the  flowchart  is  a  picture  of  the  entire  system. 
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Some  of  the  more  specific  advantages  of  flowcharts  are: 

1!  Standard  symbols  exist  (see  Figure  13-7)  so  that  flowcharting  forms  are  widely 
recognized. 

2)  Flowcharts  can  be  understood  by  someone  without  a  programming  background. 

3)  Flowcharts  can  be  used  to  divide  the  entire  project  into  sub-tasks.  The  flowchart 
can  then  be  examined  to  measure  overall  progress. 

4)  Flowcharts  show  the  sequence  of  operations  and  can  therefore  aid  in  locating  the 
source  of  errors. 

5)  Flowcharting  is  widely  used  in  other  areas  besides  programming. 

6)  There  are  many  tools  available  to  aid  in  flowcharting,  including  programmers 
templates  and  automated  drawing  packages. 

These  advantages  are  all  important.  There  is  no  question  that 
flowcharting  will  continue  to  be  widely  used.  But  we  should 
note  some  of  the  disadvantages  of  flowcharting  as  a  pro- 
gram design  method,  e.g.; 

1)  Flowcharts  are  difficult  to  design,  draw,  or  change  in  all  except  the  simplest  situa- 
tions. 

2)  There  is  no  easy  way  to  debug  or  test  a  flowchart. 

3)  Flowcharts  tend  to  become  cluttered.  Designers  find  it  difficult  to  balance  between 
the  amount  of  detail  needed  to  make  the  flowchart  useful  and  the  amount  that 
makes  the  flowchart  little  better  than  a  program  listing. 

41  Flowcharts  show  only  the  program  organization.  They  do  not  show  the  organization 
of  the  data  or  the  structure  of  the  input/output  modules. 

5)  Flowcharts  do  not  help  with  hardware  or  timing  problems  or  give  hints  as  to  where 
these  problems  might  occur. 

6)  Flowcharts  allow  for  highly  unstructured  design.  Lines  and  arrows  backtracking 
and  looping  all  over  the  chart  are  the  antithesis  of  good  structured  design  princi- 
ples. 

Thus,  flowcharting  is  a  helpful  technique  that  you  should  not  try  to  extend  too  far. 
Flowcharts  are  useful  as  program  documentation,  since  they  have  standard  forms 
and  are  comprehensible  to  non-programmers.  As  a  design  tool,  however,  flowcharts 

cannot  provide  much  more  than  a  starting  outline;  the  programmer  cannot  debug  a 
detailed  flowchart  and  the  flowchart  is  often  more  difficult  to  design  than  the  program 
itself. 
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SWITCH  AND 
LIGHT  SYSTEM 


EXAMPLES 
Response  to  a  Switch 

This  simple  task,  in  which  a  single  switch  turns  on  a  lighl 
for  one  second,  is  easy  to  flowchart.  In  fact,  such  tasks  are 
typical  examples  for  flowcharting  books,  although  they  form  a 
small  part  of  most  systems.  The  data  structure  here  is  so  simple 
that  It  can  be  safely  ignored. 

Figure  13-8  is  the  flowchart.  There  is  little  difficulty  in  deciding  on  the  amount  of 
detail  required.  The  flowchart  gives  a  straightforward  picture  of  the  procedure,  which 
anyone  could  understand. 

Note  that  the  most  useful  flowcharts  may  ignore  program  variables  and  ask  questions 
directly.  Of  course,  compromises  are  often  necessary  here.  Two  versions  of  the 
flowchart  are  sometimes  helpful  —  one  general  version  in  layman's  language, 
which  will  be  useful  to  non-programmers,  and  one  programmer's  version  in  terms 
of  the  program  variables,  which  will  be  useful  to  other  programmers. 


A  third  type  of  flowchart,  a  data  flowchart,  may  also  be  DATA 
helpful.  This  flowchart  serves  as  a  cross-reference  for  the  other  FLOWCHARTS 
flowcharts,  since  it  shows  how  the  program  handles  a  particular 
type  of  data.  Ordinary  flowcharts  show  how  the  program  proceeds,  handling  different 
types  of  data  at  different  points.  Data  flowcharts,  on  the  other  hand,  show  how  particu- 
lar types  of  data  move  through  the  system,  passing  from  one  part  of  the  program  to 
another.  Such  flowcharts  are  very  useful  in  debugging  and  maintenance,  since  errors 
most  often  show  up  as  a  particular  type  of  data  being  handled  incorrectly. 
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Figure  13-8.  Flowchart  of  One-Second  Response  to  a  Switch 


The  Switch-Based  Memory  Loader 

This  system  (see  Figure  13-3)  is  considerablv  more  complex 
than  the  previous  example,  and  involves  many  more  decisions. 
The  flowchart  {see  Figure  13-9)  is  more  difficult  to  write 
and  not  as  straightforward  as  the  previous  example.  In  this 
example,  we  face  the  problem  that  there  is  no  way  to  debug  or 
test  the  flowchart. 

The  flowchart  in  Figure  13-9  includes  the  improvements  we  suggested  as  part  of  the 
problem  definition.  Clearly,  this  flowchart  is  beginning  to  get  cluttered  and  lose  its 
advantages  over  a  written  description.  Adding  other  features  that  define  the  mean- 
ing of  the  entry  with  status  lights  and  allow  the  operator  to  check  entries  after  comple- 
tion would  make  the  flowchart  even  more  complex.  Writing  the  complete  flowchart 
from  scratch  could  quickly  become  a  formidable  task.  However,  once  the  program  has 
been  written,  the  flowchart  is  useful  as  documentation. 
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Figure  13-10.  Flowchart  of  Keyboard  Entry  Process 


The  Credit- Verification  Terminal 

In  this  application  (see  Figures  13-4  through  13-6),  the 
flowchart  will  be  even  more  complex  than  in  the  switch-based 
memory  loader  case.  Here,  the  best  idea  is  to  flowchart  sec- 
tions separately  so  that  the  flowcharts  remain  manageable. 

However,  the  presence  of  data  structures  (as  in  the  multi-digit 
display  and  the  messages)  will  make  the  gap  between 
flowchart  and  program  much  wider. 

Let  us  look  at  some  of  the  sections.  Figure  13-10  shows  the  keyboard  entry  process 

for  the  digit  keys.  The  program  must  fetch  the  data  after  each  strobe  and  place  the 
digit  into  the  display  array  if  there  is  room  for  it.  If  there  are  already  ten  digits  m  the  ar- 
ray, the  program  simply  ignores  the  entry. 

The  actual  program  will  have  to  handle  the  displays  at  the  same  time.  Note  that  either 
software  or  hardware  must  de-activate  the  kevboard  strobe  after  the  processor  reads  a 
digit. 
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Figure  13-11.  Flowchart  of  Keyboard  Entry  Process  with  Send  Key 


Figure  13-11  adds  the  Send  key.  This  key,  of  course,  is  optional.  The  terminal  could 
just  send  the  data  as  soon  as  the  operator  enters  a  complete  number.  However,  that 
procedure  would  not  give  the  operator  a  chance  to  check  the  entire  entry.  The 
flowchart  with  the  Send  key  is  more  complex  because  there  are  two  alternatives. 

1)  If  the  operator  has  not  entered  ten  digits,  the  program  must  ignore  the  Send  key 
and  place  any  other  key  into  the  entry. 

2)  If  the  operator  has  entered  ten  digits,  the  program  must  respond  to  the  Send  key  by 
transferring  control  to  the  Send  routine,  and  ignore  all  other  keys. 

Note  that  the  flowchart  has  become  much  more  difficult  to  organize  and  to  follow. 
There  is  also  no  obvious  way  to  check  the  flowchart. 
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Figure  13-12.  Flowchart  of  Keyboard  Entry  Process  w/lth  Function  Keys 

Figure  13-12  shows  the  flowchart  of  the  keyboard  entry  process  with  all  the  func- 
tion keys.  In  this  example,  the  flow  of  control  is  not  simple.  Clearly,  some  written 
description  is  necessary.  The  organization  and  layout  of  complex  flowcharts  requires 
careful  planning.  We  haye  followed  the  process  of  adding  features  to  the  flowchart  one 
at  a  time,  but  this  still  results  in  a  large  amount  of  redrawing.  Again  we  should  remem- 
ber that  throughout  the  l<eyboard  entry  process,  the  program  must  also  refresh  the  dis- 
plays if  they  are  multiplexed  and  not  controlled  by  shift  registers  or  other  hardware. 
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Figure  13-13  is  the  flowchart  of  a  receive  routine.  We  assume  that  the  serial/parallel 
conversion  and  error  checking  are  done  in  hardware  (e.g..  by  a  UART).  The  processor 
must: 

1)  Look  for  the  header  (we  assume  that  it  is  a  single  character). 

2)  Read  the  destination  address  (we  assume  that  it  is  three  characters  long)  and  see  If 
the  message  is  meant  for  this  terminal:  i.e..  if  the  three  characters  agree  with  the 
terminal  address. 

3)  Wait  for  the  trailer  character. 

4)  If  the  message  is  meant  for  the  terminal,  turn  off  the  Busy  light  and  go  to  Display 
Answer  routine. 

5)  In  the  event  of  any  errors,  request  retransmission  by  going  to  RTRAN  routine. 

This  routine  involves  a  large  number  of  decisions,  and  the  flowchart  is  neither  simple 
nor  obvious. 

Clearly,  we  have  come  a  long  way  from  the  simple  flowchart  (Figure  13-8)  of  the 
first  example.  A  complete  set  of  flowcharts  for  the  transaction  terminal  would  be 
a  major  task.  It  would  consist  of  several  interrelated  charts  with  complex  logic,  and 
would  require  a  large  amount  of  effort.  Such  an  effort  would  be  just  as  difficult  as  writ- 
ing a  preliminary  program,  and  not  as  useful,  since  you  could  not  check  it  on  the  com- 
puter. 

MODULAR  PROGRAMMING 

Once  programs  become  large  and  complex,  flowcharting  is  no  longer  a  satisfactory 
design  tool.  However,  the  problem  definition  and  the  flowchart  can  give  you  some  idea 
as  to  how  to  divide  the  program  into  reasonable  sub-tasks.  The  division  of  the  entire 
program  into  sub-tasks  or  modules  is  called  "modular  programming."  Clearly,  most 
of  the  programs  we  presented  in  earlier  chapters  would  typically  be  modules  in  a  large 
system  program.  The  problems  that  the  designer  faces  in  modular  programming  are 
how  to  divide  the  program  into  modules  and  how  to  put  the  modules  together. 

The  advantages  of  modular  programming  are  obvious: 

1)  A  single  module  is  easier  to  write,  debug,  and  test  than  an 
entire  program. 

2)  A  module  is  likely  to  be  useful  in  many  places  and  in  other 

programs,  particularly  if  it  is  reasonably  general  and  performs  a  common  task.  You 
can  build  up  a  library  of  standard  modules. 

3)  Modular  programming  allows  the  programmer  to  divide  tasks  and  use  previously 
written  programs. 

4)  Changes  can  be  incorporated  into  one  module  rather  than  into  the  entire  system. 

5)  Errors  can  often  be  isolated  and  then  attributed  to  a  single  module. 

6)  Modular  programming  gives  an  idea  of  how  much  progress  has  been  made  and 
how  much  of  the  work  is  left. 


ADVANTAGES 
OF  MODULAR 
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The  idea  of  modular  programming  is  such  an  obvious  one 
that  its  disadvantages  are  often  ignored.  These  include: 

1!    Fitting  the  modules  together  can  be  a  major  problem,  par- 
ticularly if  different  people  write  the  modules. 

2)  Modules  require  very  careful  documentation,  since  they  may  affect  other  parts  of 
the  program,  such  as  data  structures  used  by  all  the  modules. 

3)  Testing  and  debugging  modules  separately  is  difficult,  since  other  modules  may 
produce  the  data  used  by  the  module  being  debugged  and  still  other  modules  may 
use  the  results.  You  may  have  to  write  special  programs  (called  "drivers")  just  to 
produce  sample  data  and  test  the  programs.  These  drivers  require  extra  program- 
ming effort  that  adds  nothing  to  the  system. 

41  Programs  may  be  very  difficult  to  modularize.  If  vou  modulanze  the  program  poorly, 
integration  will  be  very  difficult,  since  almost  all  errors  and  changes  will  involve 
several  modules. 

5)  Modular  programs  often  require  extra  time  and  memory,  since  the  separate 
modules  may  repeat  functions. 

Therefore,  while  modular  programming  is  certainly  an  improvement  over  trying  to  wnte 
the  entire  program  from  scratch,  it  does  have  some  disadvantages  as  well. 

Important  considerations  include  restricting  the  amount  of  information  shared  by 
modules,  limiting  design  decisions  that  are  subject  to  change  to  a  single  module 
and  restricting  the  access  of  one  module  to  another.^ 

An  obvious  problem  is  that  there  are  no  proven, 
systematic  methods  for  modularizing  programs.  We 
should  mention  the  following  principles:^ 

1)  Modules  that  reference  common  data  should  be  parts  of  the  same  overall  module. 

2)  Two  modules  in  which  the  first  uses  or  depends  on  the  second,  but  not  the  reverse, 
should  be  separate. 

3)  A  module  that  is  used  by  more  than  one  other  module  should  be  part  of  a  different 
overall  module  than  the  others. 

4)  Two  modules  in  which  the  first  is  used  by  many  other  modules  and  the  second  is 
used  by  only  a  few  other  modules  should  be  separate. 

5)  Two  modules  whose  frequencies  of  usage  are  significantly  different  should  be  part 
of  different  modules. 

6)  The  structure  or  organization  of  related  data  should  be  hidden  within  a  single 
module. 

If  you  find  it  very  difficult  to  modularize  your  program,  it  is  a  strong  indication  that 
the  problem  is  poorly  defined,  and  redefinition  is  called  for.  Too  many  special  cases, 
each  requiring  special  handling,  or  the  use  of  a  large  number  of  vanables,  each  requir- 
ing special  processing,  are  problems  that  can  be  most  efficiently  handled,  by  redefining 
the  tasks  at  hand. 
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AND  LIGHT 
SYSTEM 


EXAMPLES 

Response  to  a  Switch 

This  simple  program  can  be  divided  into  two  modules: 

Module  1  waits  for  the  switch  to  be  turned  on  and  turns 
the  light  on  in  response. 

Module  2  provides  the  one-second  delay. 

Module  1  is  likely  to  be  specific  to  the  system,  since  it  will  depend  on  how  the  switch 
and  light  are  attached.  Module  2  will  be  generally  useful,  since  many  tasks  require 
delays.  Clearly,  it  would  be  advantageous  to  have  a  standard  delay  module  that  could 
provide  delays  of  varying  lengths.  The  module  will  require  careful  documentation  so 
that  vou  will  know  how  to  specify  the  length  of  the  delay,  how  to  call  the  module,  and 
what  registers  and  memory  locations  the  module  affects. 

A  general  version  of  Module  1  would  be  far  less  useful,  since  it  would  have  to  deal  with 
different  types  and  connections  of  switches  and  lights. 

You  would  probably  find  it  simpler  to  write  a  module  for  a  particular  configuration  of 
switches  and  lights  rather  than  try  to  use  a  standard  routine.  Note  the  difference  be- 
tween this  situation  and  Module  2. 

The  Switch-Based  fViemory  Loader 

The  switch-based  memory  loader  is  difficult  to  modularize, 
since  all  the  programming  tasks  depend  on  the  hardware 
configuration  and  the  tasks  are  so  simple  that  modules 
hardly  seem  worthwhile.  The  flowchart  in  Figure  13-9  sug- 
gests that  one  module  might  be  the  one  that  waits  for  the 
operator  to  press  one  of  the  three  pushbuttons. 

Some  other  modules  might  be: 

•  A  delay  module  that  provides  the  delay  required  to  debounce  the  switches 

•  A  switch  and  display  module  that  reads  the  data  from  the  switches  and  sends  it  to 
the  displays 

•  A  Lamp  Test  module 

Highly  system-dependent  modules  such  as  the  last  two  are  unlikely  to  be  generally 
useful.  This  example  is  not  one  in  which  modular  programming  offers  great  advantages. 

The  Verification  Terminal 

The  verification  terminal,  on  the  other  hand,  lends  itself  very 
well  to  modular  programming.  The  entire  system  can  easily  be 
divided  into  three  main  modules: 
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•  Keyboard  and  display  module 

•  Data  transmission  module 

•  Data  reception  module 

A  general  keyboard  and  display  module  could  handle  many  keyboard-  and  display- 
based  systems.  The  sub-modules  would  perform  such  tasks  as: 

■  Recognizing  a  new  keyboard  entry  and  fetching  the  data 

•  Clearing  the  array  in  response  to  a  Clear  key 

•  Entering  digits  into  storage 

•  Looking  for  the  terminator  or  Send  key 

•  Displaying  the  digits 
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Although  the  key  interpretations  and  the  number  of  digits  will  vary,  the  basic  entry, 
data  storage,  and  data  display  processes  will  be  the  same  for  many  programs.  Such 
function  keys  as  Clear  would  also  be  standard.  Clearly,  the  designer  must  consider 
which  modules  will  be  useful  in  other  applications,  and  pay  careful  attention  to 
those  modules. 

The  data  transmission  module  could  also  be  divided  into  such  sub-modules  as: 

1)  Adding  the  header  character. 

2)  Transmitting  characters  as  the  output  line  can  handle  them. 

3)  Generating  delay  times  between  bits  or  characters. 
4!    Adding  the  trailer  character. 

5)    Checking  for  transmission  failures:  i.e..  no  acknowledgement  or  inability  to 
transmit  without  errors. 

The  data  reception  module  could  include  sub-modules  which: 

1)  Look  for  the  header  character. 

2)  Check  the  message  destination  address  against  the  terminal  address. 
31    Store  and  interpret  the  message. 

4)  Look  for  the  trailer  character. 

5)  Generate  bit  or  character  delays. 

Note  here  how  important  it  is  that  each  design  decision  (such  as 
the  bit  rate,  message  format,  or  error-checking  procedure)  be  im- 
plemented in  only  one  module.  A  change  in  any  of  these  decisions 
will  then  require  changes  only  to  that  single  module.  The  other 
modules  should  be  written  so  that  they  are  totally  unaware  of  the  values  chosen  or  the 
methods  used  in  the  implementing  module.  An  important  concept  here  is  the  "infor- 
mation-hiding principle,"^  whereby  modules  share  only  information  that  is  ab- 
solutely essential  to  getting  the  task  done.  Other  information  is  hidden  within  a 
single  module. 

An  important  use  of  this  principle  is  in  error  handling.  Whenever  a  module  detects  a 
lethal  error,  it  should  not  undertake  recovery  procedures.  Instead,  it  should  pass  the  er- 
ror status  back  up  to  the  calling  module  and  allow  it  to  make  the  decision  of  how  to 
recover  from  the  error.  The  reason  for  this  Is  that  the  lower  level  procedure  often  does 
not  have  enough  information  to  adequately  decide  what  recovery  procedures  are 
necessary.  For  example,  suppose  we  have  a  module  that  accepts  numeric  input  from  a 
user.  This  module  terminates  normally  when  the  user  enters  a  stnng  of  numeric  digits 
terminated  by  a  carriage  return.  Entry  of  any  non-numeric  characters  causes  the 
module  to  Immediately  terminate  abnormally.  Since  the  module  does  not  know  in  what 
context  It  is  being  used  (i.e..  is  it  part  of  an  assembler,  an  interactive  editor,  or  a  file 
management  system?)  it  cannot  make  a  valid  decision  of  what  action  to  take  when  en- 
countering an  invalid  character.  If  a  single  error  recovery  method  was  designed  into  the 
module,  it  would  lose  its  generality  and  become  specific  to  those  situations  that  employ 
this  error  recovery  technique. 
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REVIEW  OF  MODULAR  PROGRAMMING 

Modular  programming  can  be  very  helpful  if  you  abide  by 
the  following  rules: 

1)  Use  modules  of  20  to  50  lines.  Shorter  modules  are 
usually  a  waste  of  time,  while  longer  modules  are  seldom 
general  and  may  be  difficult  to  integrate. 

2)  Try  to  make  modules  reasonably  general.  Differentiate  between  common 
features  like  ASCII  code  or  asynchronous  transmission  formats,  which  will  be  the 
same  for  many  applications  and  key  identifications,  and  number  of  displays  or 
number  of  characters  in  a  message,  which  are  likely  to  be  unique  to  a  particular  ap- 
plication. Make  the  changing  of  the  latter  parameters  simple.  Maior  changes  like 
different  character  codes  should  be  handled  by  separate  modules. 

3)  Take  extra  time  on  modules  like  delays,  display  handlers,  keyboard  handlers,  etc. 
that  will  be  useful  in  other  projects  or  in  many  different  places  in  the  present 
program. 

41  Try  to  keep  modules  as  distinct  and  logically  separate  as  possible.  Restrict  the 
flow  of  information  between  modules  and  implement  each  design  decision  in  a 
single  module. 

5)  Do  not  try  to  modularize  simple  tasks  where  rewriting  the  entire  task  may  be 
easier  than  assembling  or  modifying  the  module. 

STRUCTURED  PROGRAMMING 

How  do  you  keep  modules  distinct  and  stop  them  from  interacting?  How  do  you 
write  a  program  that  has  a  clear  sequence  of  operations  so  that  you  can  isolate 
and  correct  errors?  One  answer  is  to  use  the  methods  known  as  "structured  pro- 
gramming", whereby  each  part  of  the  program  consists  of  elements  from  a  limited 
set  of  structures  and  each  structure  has  a  single  entry  and  a  single  exit. 

Figure  13-14  shows  a  flowchart  of  an  unstructured  program.  If  an  error  occurs  in 
Module  B,  we  have  five  possible  sources  for  that  error.  Not  only  must  we  check  each  se- 
quence, but  we  also  have  to  make  sure  that  any  changes  made  to  correct  the  error  do 
not  affect  any  of  the  other  sequences.  The  usual  result  is  that  debugging  becomes  like 
wrestling  an  octopus.  Every  time  you  think  the  situation  is  under  control,  there  is 
another  loose  tentacle  somewhere. 


RULES  FOR 
MODULAR 
PROGRAMMING 
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Figure  13-14.  Flowchart  of  an  Unstructured  Program 


BASIC 

STRUCTURES 
OF 

STRUCTURED 
PROGRAMMING 


The  solution  is  to  establish  a  clear  sequence  of  operations  so 
that  vou  can  isolate  errors.  Such  a  sequence  uses  single-entry, 
single-exit  modules.  The  basic  modules  that  are  needed  are: 

1)  An  ordinary  sequence;  i.e..  a  linear  structure  in  which 
statements  or  structures  are  executed  consecutively.  In 
the  sequence: 

SI 
S2 
S3 

the  computer  executes  SI  first.  32  second,  and  S3  third.  SI,  82,  and  S3  may  be 
single  instructions  or  entire  programs. 

A  conditional  structure. 

The  common  one  is  "if  C  then  SI  else  S2."  where  C  is  a  condition  and  SI  and  S2 
are  statements  or  sequences  of  statements.  The  computer  executes  SI  if  C  is  true, 
and  S2  if  C  is  false.  Figure  13-15  shows  the  logic  of  this  structure.  Note  that  the 
structure  has  a  single  entry  and  a  single  exit;  there  is  no  way  to  enter  or  leaye  SI  or 
S2  other  than  through  the  structure. 

A  loop  structure. 

The  common  loop  structure  is  "while  C  do  S."  where  C  is  a  condition  and  S  is  a 
statement  or  sequence  of  statements.  The  computer  checks  C  and  executes  S  if  C 
IS  true.  This  structure  (see  Figure  13-16)  also  has  a  single  entry  and  a  single  exit. 
Note  that  the  computer  will  not  execute  S  at  all  if  C  is  originally  false,  since  the 
value  of  C  is  checked  before  S  is  executed. 


2) 


3) 
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In  most  structured  programming  languages,  an  alternative  looping  construct  is  pro- 
vided. This  construct  is  known  as  the  do-until  clause,  Its  basic  structure  is  "do  S  until 
C",  where  C  is  a  condition  and  S  is  a  statement  or  sequence  of  statements.  It  is  similar 
to  the  do-while  construct  except  that  the  test  of  the  looping  condition  C  is  performed  at 
the  end  of  the  loop.  This  has  the  effect  of  guaranteeing  that  the  loop  is  always  executed 
at  least  once.  This  is  illustrated  by  the  flowchart  in  Figure  13-17.  The  common  index- 
controlled  or  DO  loop  can  be  implemented  as  a  special  case  of  either  of  these  two  basic 
looping  constructs. 
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Figure  13-17,  Flowchart  of  the  Do-Until  Structure 

4)    A  case  structure. 

Although  not  a  primitive  structure  like  sequential,  if-then-else.  and  do-while,  the 
case  structure  is  so  commonly  used  that  we  include  it  here  as  an  adjunct  to  the 
basic  structure  descriptions.  The  case  structure  is  "case  I  of  SO,  SI.  ,  .Sn",  where  I 
IS  an  index  and  SO.  81,  .  .Sn  are  statements  or  sequences  of  statements.  If  I  is 
equal  to  zero  then  statement  SO  is  executed;  if  I  is  equal  to  1  then  statement  SI  is 
executed,  etc.  Only  one  of  the  n  statements  is  executed.  After  its  execution,  control 
passes  to  the  next  sequential  statement  following  the  case  statement  group.  If  I  is 
greater  than  n  (i.e.,  the  number  of  statements  in  the  case  statement),  then  none  of 
the  statements  in  the  case  statement  is  executed,  and  control  is  passed  directly  to 
the  next  sequential  statement  following  the  case  statement  This  is  illustrated  by 
the  flowchart  in  Figure  13-18, 

Note  the  following  features  of  structured  programming: 

1)  Only  the  three  basic  structures,  and  possibly  a  small  number  of  auxiliary 
structures,  are  permitted. 

2)  Structures  may  be  nested  to  any  level  of  complexity  so  that  any  program  can, 
in  turn,  contain  any  of  the  structures. 

3)  Each  structure  has  a  single  entry  and  a  single  exit. 

Some  examples  of  the  conditional  structure  illustrated  in 
Figure  13-15  are: 

1!    S2  included: 

if  X  ^  0  then  NPOS  =  NPOS  +  1 
else  NNEG  =  NNEG  +  1 

Both  SI  and  S2  are  single  statements. 
2)    S2  omitted; 

if  X  '^O  then  Y  =  1/X 

Here  no  action  is  taken  if  C  (X  ^0)  is  false,  S2  and  "else"  can  be  omitted  in  this  case. 


EXAMPLES 
OF 

STRUCTURES 
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^         End  ^ 


Figure  13-18.  Flowchart  of  the  Case  Structure 

Some  examples  of  the  loop  structure  illustrated  in  Figure  13-16  are: 

II    Form  the  sum  of  integers  from  1  to  N, 
1=0 
SUM  =0 
do  while  I  <  N 
1=1  +  1 

SUM  =  SUM  +  I 
end 

The  computer  executes  the  loop  as  long  as  i  <  N.  If  N  =  0,  the  program  within  the  "do- 
while"  is  not  executed  at  all. 

2)    Count  characters  in  an  array  SENTENCE  until  you  find  an  ASCII  period. 
NCHAR  =0 

do  while  SENTENCE  (NCHAR)  ?t  PERIOD 

NCHAR  =  NCHAR  -I-  1 
end 

The  computer  executes  the  loop  as  long  as  the  character  in  SENTENCE  is- not  an  ASCII 
period.  The  count  is  zero  if  the  first  character  is  a  period. 
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ADVANTAGES  OF 

STRUCTURED 

PROGRAMMING 


The  advantages  of  structured  programming  are: 

1)  The  sequence  of  operations  is  simple  to  trace.  This  allows 
you  to  test  and  debug  easily. 

2)  The  number  of  structures  is  limited  and  the  terminology  is 
standardized. 

3)  The  structures  can  easily  be  made  into  modules. 

4)  Theoreticians  have  proved  that  the  given  set  of  structures  is  complete:  that  is,  all 
programs  can  be  written  in  terms  of  the  three  structures. 

5)  The  structured  version  of  a  program  is  partly  self-documenting  and  fairly  easy  to 
read. 

6)  Structured  programs  are  easy  to  describe  with  program  outlines. 

7)  Structured  programming  has  been  shown  in  practice  to  increase  programmer  pro- 
ductivity. 

Structured  programming  basically  forces  much  more  discipline  on  the  programmer 
than  does  modular  programming.  The  result  is  more  systematic  and  better- 
organized  programs. 


DISADVANTAGES 
OF 

STRUCTURED 
PROGRAMMING 


The  disadvantages  of  structured  programming  are: 

1)  Only  a  few  high-level  languages  (e.g..  PL/M,  PASCAL)  will 
directly  accept  the  structures.  The  programmer  therefore 
has  to  go  through  an  extra  translation  stage  to  convert  the 
structures  to  assembly  language  code.  The  structured  ver- 
sion of  the  program,  however,  is  often  useful  as  documentation. 

2)  Structured  programs  often  execute  more  slowly  and  use  more  memory  than 
unstructured  programs. 

3)  Limiting  the  structures  to  the  four  basic  forms  makes  some  tasks  verv  awkward  to 
perform.  The  completeness  of  the  structures  only  means  that  all  programs  can  be 
implemented  with  them;  it  does  not  mean  that  a  given  program  can  be  imple- 
mented efficiently  or  conveniently. 

41  The  standard  structures  are  often  quite  confusing,  e.g..  nested  "if-then-else"  struc- 
tures may  be  very  difficult  to  read,  since  there  may  be  no  clear  indication  of  where 
the  inner  structures  end.  A  series  of  nested  "do-while"  loops  can  also  be  difficult  to 
read. 

5)  Structured  programs  consider  only  the  sequence  of  program  operations,  not  the 
flow  of  data.  Therefore,  the  structures  may  handle  data  awkwardly. 

6)  Few  programmers  are  accustomed  to  structured  programming.  Many  find  the  stan- 
dard structures  awkward  and  restrictive. 

We  are  neither  advocating  nor  discouraging  the  use  of  structured  programming.  It 
is  one  way  of  systematizing  program  design.  In  general,  structured  programming 
is  most  useful  in  the  follov/ing  situations: 


•  Larger  programs,  perhaps  exceeding  1000  instructions 

•  Applications  in  which  memory  usage  is  not  critical. 

•  Low-volume  applications  where  software  development  costs, 
particularly  testing  and  debugging,  are  important  factors. 

•  Applications  involving  string  manipulation,  process  control 
or  other  algorithms  rather  than  simple  bit  manipulations. 


WHEN  TO  USE 

STRUCTURED 

PROGRAMMING 
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In  the  future,  we  expect  the  cost  of  memory  to  decrease,  the  average  size  of 
microprocessor  programs  to  increase,  and  the  cost  of  software  development  to 
increase.  Therefore,  methods  like  structured  programming,  which  decrease  soft- 
ware development  costs  for  larger  programs  but  use  more  memory,  will  become 
more  valuable. 

Just  because  structured  programming  concepts  are  usually  expressed  in  high-level 
languages  does  not  mean  that  structured  programming  is  not  applicable  to  assembly 
language  programming.  On  the  contrary,  the  assembly  language  programmer,  with  the 
total  freedom  of  expression  that  assembly  level  programming  allows,  needs  the  struc- 
tunng  concepts  provided  by  structured  programming.  Creating  modules  with  single 
entry  and  exit  points,  using  simple  control  structures  and  keeping  the  complexity  of 
each  module  minimal  makes  assembly  language  coding  more  efficient. 


EXAMPLES 

Besponse  to  a  Switch 

The  structured  version  of  this  example  is: 

SWITCH  =  OFF 

do  while  SWITCH  =  OFF 

READ  SWITCH 
end 

LIGHT  =  ON 
DELAY  1 
LIGHT  =  OFF 


STRUCTURED 
PROQRAIVIMING 
IN  THE 
SWITCH  AND 
LIGHT  SYSTEM 


ON  and  OFF  must  have  the  proper  definitions  for  the  switch  and  light.  We  assume  that 
DELAY  is  a  module  that  provides  a  delay  given  by  its  parameter  in  seconds. 

A  statement  in  a  structured  program  may  actually  be  a  subroutine.  However,  in  order  to 
conform  to  the  rules  of  structured  programming,  the  subroutine  cannot  have  any  exits 
other  than  the  one  that  returns  control  to  the  main  program. 

Since  "do-while"  checks  the  condition  before  executing  the  loop,  we  set  the  vanable 
SWITCH  to  OFF  before  starting.  The  structured  program  is  straightforward,  readable, 
and  easy  to  check  by  hand.  However,  it  would  probably  require  somewhat  more  memo- 
ry than  an  unstructured  program,  which  would  not  have  to  initialize  SWITCH  and  could 
combine  the  reading  and  checking  procedures. 

The  Switch-Based  Memory  Loader   

The  switch-based  memory  loader  is  a  more  complex  struc-  STRUCTURED 
tured  programming  problem.  We  may  implement  the  PROGRAMMING 
flowchart  of  Figure  13-9  as  follows  (an  •  indicates  a  com-    FOR  THE 
ment):  SWITCH-BASED 

I  MEMORY  LOADER 

•  INITIALIZE  VARIABLES 

HIADDRESS  =  0 
LOADDRESS  =  0 

•  THIS  PROGRAM  USES  A  DO-WHILE  CONSTRUCT  WITH  NO  CONDITION 

■  (CALLED  SIMPLY  DO-FOREVER).  THEREFORE,  THE  SYSTEM  CONTINUALLY 

•  EXECUTES  THE  PROGRAM  CONTAINED  IN  THIS  DO-WHILE  LOOP. 

do  forever 
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•  TEST  FOR  HIADDRESS  BUTTON;  PERFORM  THE  REQUIRED  PROCESSING 

•  IF  IT  IS  ON. 

if  HIADDRBUTTON  =  1  then 
begin 

HIADDRESS  =  SWITCHES 
LIGHTS  =  SWITCHES 
do 

DELAY  (DEBOUNCE  TIME) 
until  HIADDRBUTTON  *^  1 
end 

•  TEST  FOR  LOADDRESS  BUTTON;  PERFORM  LOW  ADDRESS  PROCESSIMG 

■  IF  IT  IS  ON. 

if  LOADDRBUTTON  =  1  then 
begin 

LOADDRESS  =  SWITCHES 
LIGHTS  =  SWITCHES 
do 

DELAY  (DEBOUNCE  TIME) 
until  LOADDRBUTTON  ?t  1 
end 

•  TEST  FOR  DATABUTTON,  AND  STORE  DATA  INTO  MEMORY 

■  IF  IT  IS  ON. 

if  DATABUTTON  =  1  then 
begin 
DATA  =  SWITCHES 
LIGHTS  =  SWITCHES 
(HIADDRESS,  LOADDRESS)  =  DATA 
do 

DELAY  IDEBOUNCE  TIME) 
until  DATABUTTON  4=  1 
end 

end 

•  THE  LAST  END  ABOVE  TERMINATES  THE 

do  forever  LOOP 

Structured  programs  are  not  easy  to  write,  but  thev  can  give  a  great  deal  of  insight  into 
the  overall  program  logic.  You  can  check  the  logic  of  the  structured  program  by  hand 
before  writing  any  actual  code. 
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The  Ci-edit-Verification  Terminal 


Let  us  look  at  the  keyboard  entry  for  the  transaction  terminal. 

We  will  assume  that  the  display  array  is  ENTRY,  the  keyboard 
strobe  is  KEYSTROBE.  and  the  keyboard  data  is  KEYIN.  The  struc- 
tured program  without  the  function  keys  is: 

NKEYS  = 10 

•  CLEAR  ENTRY  TO  START 


do  while  NKEYS  >  0 

NKEYS  =  NKEYS - 1 

ENTRY  (NKEY  81  =0  ' 
end 

•  FETCH  A  COMPLETE  ENTRY  FROM  KEYBOARD 

do  while  NKEYS  <  10 

if  KEYSTROBE  =  ACTIVE  then 
begin 

KEYSTROBE  =  INACTIVE 
ENTRY(NKEYS)  =  KEYIN 
NKEYS  =  NKEYS  +  1 
end 

end 

Adding  the  SEND  key  means  that  the  program  must  ignore  extra  digits  after  it  has 
a  complete  entry,  and  must  ignore  the  SEND  key  until  it  has  a  complete  entry.  The 
structured  program  is: 

NKEYS  = 10 

■  CLEAR  ENTRY  TO  START 

do  while  NKEYS  >  0 

NKEYS  =  NKEYS -  1 

ENTRY(NKEYS)  =0 
end 

•  WAIT  FOR  COMPLETE  ENTRY  FOLLOWED  BY  SEND  KEY 

do  while  KEY  ?tSEND  or  NKEYS  ^10 
if  KEYSTROBE  =  ACTIVE  then 
begin 

KEYSTROBE  =  INACTIVE 
KEY  =  KEYIN 

if  NKEYS  5^10  and  KEY  jtSEND  then 
begin 

ENTRY(NKEYS)  =  KEY 
NKEYS  =  NKEYS  +  1 
end 

end 

end 


STRUCTURED 
PROGRAM  FOR 
THE  CREDIT- 
VERIFICATION 
TERMINAL 


STRUCTURED 

KEYBOARD 

ROUTINE 


13-38 


Note  the  following  features  of  this  structured  program. 

1)  The  second  if-then  is  nested  within  the  first  one,  since  keys  are  only  entered  after  a 
strobe  is  recognized.  If  the  second  if-then  were  on  the  same  level  as  the  first,  a 
single  key  could  fill  the  entry,  since  its  value  would  be  entered  into  the  array  during 
each  iteration  of  the  do-while  loop. 

2)  KEY  need  not  be  defined  initially,  since  NKEYS  is  set  to  zero  as  part  of  the  clear- 
ing of  the  entry. 

Adding  the  CLEAR  key  allows  the  program  to  clear  the  entry  originally  by  simulat- 
ing the  pressing  of  CLEAR;  i.e.,  by  setting  NKEYS  to  10  and  KEY  to  CLEAR  before 
starting.  The  structured  program  must  also  clear  only  digits  that  have  previously  been 
filled.  The  new  structured  program  is: 

•  SIMULATE  COMPLETE  CLEARING 

NKEYS  = 10 
KEY  =  CLEAR 

•  WAIT  FOR  COMPLETE  ENTRY  AND  SEND  KEY 
do  while  KEY  ^^SEND  or  NKEYS  10 

•  CLEAR  WHOLE  ENTRY  IF  CLEAR  KEY  STRUCK 

if  KEY  =  CLEAR  then 
begin 
KEY  =0 

do  while  NKEYS  >  0 

NKEYS  =  NKEYS  -  1 

ENTRY(NKEYS)  =0 
end 
end 

•  GET  DIGIT  IF  ENTRY  INCOMPLETE 


if  KEYSTROBE  =  ACTIVE  then 
begin 

KEYSTROBE  =  INACTIVE 
KEY  =  KEYIN 

if  KEY  <  10  and  NKEYS  #10  then 
begin 

ENTRY  (NKEYS)  =  KEY 
NKEYS  =  NKEYS  -I-  1 
end 

end 

end 

Note  that  the  program  resets  KEY  to  zero  after  clearing  the  array,  so  that  the  operation  is 
not  repeated. 
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We  can  similarly  build  a  structured  program  for  the  receive  STRUCTURED 

routine.  An  initial  program  could  look  just  for  the  header  and  RECEIVE 

trailer  characters.  We  will  assume  that  RSTB  is  the  indicator  that  a  ROUTINE 
character  is  ready.  The  structured- program  is: 


•  CLEAR  HEADER  FLAG  TO  START 
HFLAG  =  0 

■  WAIT  FOR  HEADER  AND  TRAILER 
do  while  HFLAG  =  0  or  CHAR  ^TRAILER 


GET  CHARACTER  IF  READY,  LOOK  FOR  HEADER 


if  RSTB  =  ACTIVE  then 
begin 
RSTB  =  INACTIVE 
CHAR  =  INPUT 

if  CHAR  =  HEADER  then  HFLAG  =  1 
end 
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Now  we  can  add  the  section  that  checks  the  message  address  against  the  three 
digits  in  TERMINAL  ADDRESS  (TERMADDR).  If  any  of  the  corresponding  digits 
are  not  equal,  the  ADDRESS  MATCH  flag  (ADDRMATCH)  is  set  to  1. 

•  CLEAR  HEADER  FLAG,  ADDRESS  MATCH  FLAG,  ADDRESS  COUNTER  TO  START 

HFLAG  =  0 
ADDRMATCH  =  0 
ADDRCTR  =  0 

•  WAIT  FOR  HEADER.  DESTINATION  ADDRESS  AND  TRAILER 
do  while  HFLAG  =  0  or  CHAR  5^ TRAILER  OR  ADDRCTR  5*^3 

•  GET  CHARACTER  IF  READY 

if  RSTB  =  ACTIVE  then 
begin 

RSTB  =  INACTIVE 

CHAR  =  INPUT 
end 

•  CHECK  FOR  TERMINAL  ADDRESS  AND  HEADER 

if  HFLAG  =  1  and  ADDRCTR  ^3  then 
begin 

ADDRMATCH  =  1 

ADDRCTR  =  ADDRCTR  +  1 
end 

if  CHAR  =  HEADER  then  HFLAG  =  1 

end 

The  program  must  now  wait  for  a  header,  a  three-digit  identification  code,  and  a  trailer. 
You  must  be  careful  of  what  happens  during  the  iteration  when  the  program  finds  the 
header,  and  of  what  happens  if  an  erroneous  identification  code  character  is  the  same 
as  the  trailer. 
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A  further  addition  can  store  the  message  in  MESSG.  NMESS  is  the  number  of 
characters  in  the  message;  if  it  is  not  zero  at  the  end,  the  program  knows  that  the 
terminal  has  received  a  valid  message.  We  have  not  tried  to  minimize  the  logic  ex- 
pressions in  this  program. 

•  CLEAR  FLAGS,  COUNTERS  TO  START 

HFLAG  =  0 
ADDRMATCH  =  0 
ADDRCTR  =  0 
NMESS  =0 

•  WAIT  FOR  HEADER,  DESTINATION  ADDRESS  AND  TRAILER 
do  while  HFLAG  =  0  or  CHAR    TRAILER  or  ADDRCTR  ^3 

■  GET  CHARACTER  IF  READY 

if  RSTB  =  ACTIVE  then 
begin 

RSTB  =  INACTIVE 

CHAR  =  INPUT 
end 

■  READ  MESSAGE  IF  DESTINATION  ADDRESS  =  TERMINAL  ADDRESS 

if  HFLAG  =  1  and  ADDRCTR  =  3  then 
if  ADDRMATCH  =  0  and  CHAR    TRAILER  then 
begin 

MESSG(NMESS)  =CHAR 
NMESS  =  NMESS  +  1 
end 

.  CHECK  FOR  TERMINAL  ADDRESS 

if  HFLAG  =  1  and  ADDRCTR  ^^3  then 
if  CHAR  ?^^TERMADDR(ADDRCTR)  then 
begin 

ADDRMATCH  =  1 

ADDRCTR  =  ADDRCTR  +  1 
end 

•  LOOK  FOR  HEADER 

if  CHAR  =  HEADER  then  HFLAG  =  1 

end 
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The  program  checks  for  the  identification  code  only  if  it  found  a  header  during  a  pre- 
vious iteration.  It  accepts  the  message  only  if  it  has  previously  found  a  header  and  a 
complete,  matching  destination  address.  The  program  must  work  properly  during  the 
iterations  when  it  finds  the  header,  the  trailer  and  the  last  digit  of  the  destination  ad- 
dress, it  must  not  try  to  match  the  header  with  the  terminal  address  or  place  the  trailer 
or  the  final  digit  of  the  destination  address  in  the  message.  You  might  try  adding  the 
rest  of  the  logic  from  the  flowchart  (Figure  13-13)  to  the  structured  program.  Note 
that  the  order  of  operations  is  often  critical.  You  must  be  sure  that  the  program 
does  not  complete  one  phase  and  start  the  next  one  during  the  same  iteration. 

REVIEW  OF  STRUCTURED  PROGRAMMING 

Structured  programming  brings  discipline  to  program  design.  It  forces  you  to  limit 
the  types  of  structures  you  use  and  the  sequence  of  operations.  It  provides  single- 
entry,  single-exit  structures,  which  you  can  check  for  logical  accuracy.  Structured 
programming  often  makes  the  designer  aware  of  inconsistencies  or  possible  com- 
binations of  inputs.  Structured  programming  is  not  a  cure-all,  but  it  does  bring 
some  order  into  a  process  that  can  be  chaotic.  The  structured  program  should  also 
aid  in  debugging,  testing,  and  documentation. 

Structured  programming  is  not  simple.  The  programmer  must  not  only  define  the 
problem  adequately,  but  must  also  work  through  the  logic  carefully.  This  is 
tedious  and  difficult,  but  it  results  in  a  clearly  written,  working  program. 

The  particular  structures  we  have  presented  are  not  ideal  and  TERMINATORS 
are  often  awkward.  In  addition,  it  can  be  difficult  to  dis-  FOR 
tinguish  where  one  structure  ends  and  another  begins,  partic-  STRUCTURES 
ularly  if  they  are  nested.  Theorists  may  provide  better  struc- 
tures in  the  future,  or  designers  may  wish  to  add  some  of  their  own.  Some  kind  of 
terminator  for  each  structure  seems  necessary,  since  indenting  does  not  always  clarify 
the  situation.  "End"  is  a  logical  terminator  for  the  "do-while"  loop.  There  is  no  obvious 
terminator,  however,  for  the  "if-then-eise"  statement:  some  theorists  have  suggested 
"endif"  or  "fi"  ("if"  backwards),  but  these  are  both  awkward  and  detract  from  the 
readability  of  the  program. 

We  suggest  the  following  rules  for  applying  structured  pro- 
gramming: 

1)  Begin  by  writing  a  basic  flowchart  to  help  define  the 
logic  of  the  program. 

2)  Start  with  the  "sequential,"  "if-then-else,"  and  "do-while"  constructs.  They 
are  known  to  be  a  complete  set,  i.e.,  any  program  can  be  written  in  terms  of  these 
structures. 

3)  Indent  each  level  a  few  spaces  from  the  previous  level,  so  that  you  will  know 
which  statements  belong  where. 

4)  Use  terminators  for  each  structure;  e.g.,  "end"  for  the  "do-while"  and  "endif"  or 
"fi"  for  the  "if-then-e(se"  The  terminators  plus  the  indentation  should  make  the 
program  reasonably  clear. 

5)  Emphasize  simplicity  and  readability.  Leave  lots  of  spaces,  use  meaningful 
names,  and  make  expressions  as  clear  as  possible.  Do  not  try  to  minimize  the  logic 
at  the  cost  of  clarity. 

6)  Comment  the  program  in  an  organized  manner. 

7)  Check  the  logic.  Try  all  the  extreme  cases  or  special  conditions  and  a  few  sample 
cases.  Any  logical  errors  you  find  at  this  level  will  not  plague  vou  later. 
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The  remaining  problem  is  how  to  check  and  integrate  modules 
or  structures.  Certainly  we  want  to  divide  a  large  task  into 
sub- tasks.  But  how  do  we  check  the  sub-tasks  in  isolation  and 
put  them  together?  The  standard  procedure,  called  "bottom-up  design,"  requires 
extra  work  in  testing  and  debugging  and  leaves  the  entire  integration  task  to  the 
end.  What  we  need  is  a  method  that  allows  testing  and  debugging  in  the  actual 
program  environment  and  modularizes  system  integration. 

This  method  is  "top-down  design,"  Here  we  start  by  writing 
the  overall  supervisor  program.  We  replace  the  undefined  sub- 
programs by  program  "stubs,"  temporary  programs  that  may 
either  record  the  entry,  provide  the  answer  to  a  selected  test 
problem,  or  do  nothing.  We  then  test  the  supervisor  program 
to  see  that  its  logic  is  correct. 

We  proceed  by  expanding  the  stubs.  Each  stub  will  often  con- 
tain sub-tasks,  which  we  will  temporarily  represent  as  stubs. 
This  process  of  expansion,  debugging,  and  testing  continues 
until  all  the  stubs  are  replaced  by  working  programs.  Note  that 
testing  and  integration  occur  at  each  level,  rather  than  all  at  the 
end.  No  special  driver  or  data  generation  programs  are  necessary. 
We  get  a  clear  idea  of  exactly  where  we  are  in  the  design.  Top- 
down  design  assumes  modular  programming,  and  is  compatible  with  structured 
programming  as  well. 

The  disadvantages  of  top-down  design  are: 
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The  overall  design  may  not  mesh  we 
ware. 

2)  It  may  not  take  good  advantage  of  existing  software. 

3)  Stubs  may  be  difficult  to  write,  particularly  if  they  must 
work  correctly  in  several  different  places. 

4)  Top-down  design  may  not  result  in  generally  useful  modules. 

5)  Errors  at  the  top  level  can  have  catastrophic  effects,  whereas  errors  in  bottom-up 
design  are  usually  limited  to  a  particular  module. 

In  large  programming  projects,  top-down  design  has  been  shown  to  greatly  im- 
prove programmer  productivity.  However,  almost  all  of  these  projects  have  used 
some  bottom-up  design  in  cases  where  the  top-down  method  would  have 
resulted  in  a  large  amount  of  extra  work. 

Top-down  design  is  a  useful  tool  that  should  not  be  followed  to  extremes.  It  pro- 
vides the  same  discipline  for  system  testing  and  integration  that  structured  pro- 
gramming provides  for  module  design.  The  method,  however,  has  more  general 
applicability,  since  it  does  not  assume  the  use  of  programmed  logic.  However, 
top-down  design  may  not  result  in  the  most  efficient  implementation. 
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EXAMPLES 
Response  to  a  Switch 

The  first  structured  programming  example  actually  demon- 
strates top-down  design  as  well.  The  program  was: 

SWITCH  =  OFF 
do  while  SWITCH  =  OFF 

READ  SWITCH 
end 

LIGHT  =  ON 
DELAY  1 
LIGHT  =  OFF 

These  statements  are  really  stubs,  since  none  of  them  is  fully  defined.  For  exam- 
ple, what  does  READ  SWITCH  mean?  If  the  switch  were  one  bit  of  input  port  SPORT,  it 
really  means: 

SWITCH  =  SPORT  AND  SMASK 

where  SMASK  has  a  '1'  bit  in  the  appropriate  position.  The  masking  may,  of  course,  be 
implemented  with  a  Bit  Test  instruction. 

Similarly,  DELAY  1  actually  means  (if  the  processor  itself  provides  the  delay): 

REG  =  COUNT 
do  while  REG  5^=0 

REG  =  REG  -  1 
end 

COUNT  is  the  appropriate  number  to  provide  a  one-second  delay.  The  expanded  ver- 
sion of  the  program  is: 

SWITCH  =  0 

do  while  SWITCH  =  0 

SWITCH  =  SPORT  AND  MASK 
end 

LIGHT  =  ON 
REG  =  COUNT 
do  while  REG  ^0 
REG  =  REG  -  1 
end 

LIGHT  =  NOT  (LIGHT) 

Certainly  this  program  is  more  explicit,  and  could  more  easily  be  translated  into 
actual  instructions  or  statements. 


TOP-DOWN 
DESIGN 
OF  SWITCH 
AND  LIGHT 
SYSTEM 


13-45 


The  Switch-Based  Memory  Loader 


This  example  is  more  complex  than  the  first  example,  so  we 
must  proceed  systematicaliv.  Here  again,  the  structured  pro- 
gram contains  stubs. 

For  example,  if  the  HIGH  ADDRESS  button  is  one  bit  of  input 
port  CPORT,  "if  HIADDRBUTTON  =  1"  really  means: 

1)  Input  from  CPORT 

2)  Complement 

3)  Logical  AND  with  HAMASK 

where  HAMASK  has  a  '1'  in  the  appropriate  bit  position  and  'Os'  elsewhere.  Similarly 
the  condition  "if  DATABUTTON  =  1"  really  means: 

1)  Input  from  CPORT 

2)  Complement 

3)  Logical  AND  with  DAMASK 

So,  thejnitial  stubs  could  just  assign  values  to  the  buttons,  e.g., 

HIADDRBUTTON  =  0 
LOADDRBUTTON  =  0 
DATABUTTON  =  0 

A  run  of  the  supervisor  program  should  show  that  it  takes  the  implied  "else"  path 
through  the  "if-then-else"  structures,  and  never  reads  the  switches.  Similarly,  if  the 
stub  were: 

HIADDRBUTTON  =  1 

the  supervisor  program  should  stay  in  the  "do  while  HIADDRBUTTON  =  1"  loop  wait- 
ing for  the  button  to  be  released.  These  simple  runs  check  the  overall  logic. 

Now  we  can  expand  each  stub  and  see  if  the  expansion  produces  a  reasonable 
overall  result.  Note  how  debugging  and  testing  proceed  in  a  straightforward  and 
modular  manner.  We  expand  the  HIADDRBUTTON  =  1  stub  to: 

READ  CPORT 

HIADDRBUTTON  =  NOT  (CPORT)  AND  HAMASK 

The  program  should  wait  for  the  HIGH  ADDRESS  button  to  be  closed.  The  program 
should  then  display  the  values  of  the  switches  on  the  lights.  This  run  checks  for  the 
proper  response  to  the  HIGH  ADDRESS  button. 

We  then  expand  the  LOW  ADDRESS  button  module  to: 

READ  CPOflT 

LOADDhBUTTON  =  NOT  (CPORT)  AND  LAMASK 

With  the  LOW  ADDRESS  button  in  the  closed  position,  the  program  should  display  the 
values  of  the  switches  on  the  lights.  This  run  checks  for  the  proper  response  to  the  LOW 
ADDRESS  button. 

Similarly,  we  can  expand  the  DATA  button  module  and  check  for  the  proper  response 
to  that  button.  The  entire  program  will  then  have  been  tested. 

When  all  the  stubs  have  been  expanded,  the  coding,  debugging,  and  testing 
stages  will  all  be  complete.  Of  course,  we  must  know  exactly  what  results  each 
stub  should  produce.  However,  many  logical  errors  will  become  obvious  at  each 
level  without  any  further  expansion. 
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Figure  13-19  Initial  Flowchart  for  Transaction  Terminal 

The  Transaction  Terminal 

This  example,  of  course,  will  have  more  levels  of  detail.  We 
could  start  with  the  following  program  (see  Figure  13-19  for 
a  flowchart): 

KEYBOARD 
ACK  =0 

do  while  ACK  =  0 

TRANSMIT 

RECEIVE 
end 

DISPLAY 

Here  KEYBOARD,  TRANSMIT,  RECEIVE,  and  DISPLAY  are  program  stubs  that  will 
be  expanded  later.  KEYBOARD,  for  example,  could  simply  place  a  ten-digit  verified 
number  into  the  appropriate  buffer. 
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Complete  =  0 
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Figure  13-20.  Flowchart  for  Expanded  KEYBOARD  Routine 
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The  next  stage  of  expansion  could  produce  the  following  pro- 
gram for  KEYBOARD  (see  Figure  1 3-20) ; 

VER  =0 

do  wtiile  VER  =  0 
COMPLETE  =  0 
do  while  COMPLETE  =  0 
KEYIN 
KEYDS 
end 
VERIFY 
end 

Here  VER  =0  means  that  an  entry  has  not  been  verified;  COMPLETE  =0  means  that 
the  entry  is  incomplete.  KEYIN  and  KEYDS  are  the  keyboard  input  and  display  routines 
respectively  VERIFY  checks  the  entry.  A  stub  for  KEYIN  would  simply  place  a  random 
entry  (from  a  random  number  table  or  generator)  into  the  buffer  and  set  COMPLETE  to 
1. 

We  would  continue  by  similarly  expanding,  debugging,  and  testing  TRANSMIT, 
RECEIVE,  and  DISPLAY.  Note  that  you  should  expand  each  program  by  one  level 
so  that  you  do  not  perform  the  integration  of  an  entire  program  at  any  one  time. 
You  must  use  your  judgment  in  defining  levels.  Too  small  a  step  wastes  time, 
while  too  large  a  step  gets  you  back  to  the  problems  of  system  integration  that 
top-down  design  is  supposed  to  solve. 
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REVIEW  OF  TOP-DOWN  DESIGN 

Top-down  design  brings  discipline  to  the  testing  and  integration  stages  of  pro- 
gram design.  It  provides  a  systematic  method  for  expanding  a  flowchart  or  prob- 
lem definition  to  the  level  required  to  actually  write  a  program.  Together  with 
structured  programming,  it  forms  a  complete  set  of  design  techniques. 

Like  structured  programming,  top-down  design  is  not  simple.  The  designer  must 
have  defined  the  problem  carefully  and  must  work  systematically  through  each 
level.  Here  again  the  methodology  may  seem  tedious,  but  the  payoff  can  be  sub- 
stantial if  you  follow  the  rules. 

We  recommend  the  following  approach  to  top-down  design: 
1 )    Start  with  a  basic  flowchart. 

2j    Make  the  stubs  as  complete  and  as  separate  as  possible. 

3)  Define  precisely  all  the  possible  outcomes  from  each  stub 

and  select  a  test  set. 

4)  Check  each  level  carefully  and  systematically- 

5)  Use  the  structures  from  structured  programming. 

6)  Expand  each  stub  by  one  level.  Do  not  try  to  do  too  much  in  one  step. 

7)  Watch  carefully  for  common  tasks  and  data  structures. 

8)  Test  and  debug  after  each  stub  expansion.  Do  not  try  to  do  an  entire  level  at  a 
time. 

9)  Be  aware  of  what  the  hardware  can  do.  Do  not  hesitate  to  stop  and  do  a  little 
bottom-up  design  where  that  seems  necessary. 

REVIEW  OF  PROBLEM  DEFINITION  AND  PROGRAM  DESIGN 

You  should  note  that  we  have  spent  an  entire  chapter  without  mentioning  any 
specific  microprocessor  or  assembly  language,  and  without  writing  a  single  line  of 
actual  code.  Hopefully,  though,  you  now  know  a  lot  more  about  the  examples  than 
you  would  have  if  we  had  Just  asked  you  to  write  the  programs  at  the  start. 
Although  we  often  think  of  the  writing  of  computer  instructions  as  a  key  part  of 
software  development,  it  is  actually  one  of  the  easiest  stages. 

Once  you  have  written  a  few  programs,  coding  will  become  simple.  You  will  soon 
learn  the  instruction  set,  recognize  which  instructions  are  really  useful,  and 
remember  the  common  sequences  that  make  up  the  largest  part  of  most  pro- 
grams. You  will  then  find  that  many  of  the  other  stages  of  software  development 
remain  difficult  and  have  few  clear  rules. 

We  have  suggested  here  some  ways  to  systematize  the  important  early  stages.  In 
the  problem  definition  stage,  you  must  define  all  the  characteristics  of  the 
system  —  its  inputs,  outputs,  processing,  time  and  memory  constraints,  and  error 
handling.  You  must  particularly  consider  how  the  system  will  interact  with  the 
larger  system  of  which  it  is  a  part,  and  whether  that  larger  system  includes 
electrical  equipment,  mechanical  equipment,  or  a  human  operator.  You  must  start 
at  this  stage  to  make  the  system  easy  to  use  and  maintain. 

In  the  program  design  stage,  several  techniques  can  help  you  to  systematically 
specify  and  document  the  logic  of  your  program.  Modular  programming  forces  you 
to  divide  the  total  program  into  small,  distinct  modules.  Structured  programming 
provides  a  systematic  way  of  defining  the  logic  of  those  modules,  while  top-down 
design  is  a  systematic  method  for  integrating  and  testing  them.  Of  course,  no  one 
can  compel  you  to  follow  all  of  these  techniques;  they  are,  in  fact,  guidelines  more 
than  anything  else.  But  they  do  provide  a  unified  approach  to  design,  and  you 
should  consider  them  a  basis  on  which  to  develop  your  own  approach. 
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Chapter  14 
DEBUGQIhlG  AND  TESTING 


As  we  noted  at  the  beginning  of  the  previous  chapter,  debugging  and  testing  are 
among  the  most  time-consuming  stages  of  software  development.  Even  though  such 
methods  as  modular  programming,  structured  programming,  and  top-down  design 
can  simplify  programs  and  reduce  the  frequency  of  errors,  debugging  and  testing 
still  are  difficult  because  they  are  so  poorly  defined.  The  selection  of  an  adequate  set 
of  test  data  is  seldom  a  clear  or  scientific  process.  Finding  errors  sometimes  seems  like  a 
game  of  "pin  the  tail  on  the  donkey."  except  that  the  donkey  is  moving  and  the  pro- 
grammer must  position  the  tail  by  remote  control.  Surely,  few  tasks  are  as  frustrating  as 
debugging  programs. 

This  chapter  will  first  describe  the  tools  available  to  aid  in  debugging.  It  will  then 
discuss  basic  debugging  procedures,  describe  the  common  types  of  errors,  and 
present  some  examples  of  program  debugging.  The  last  sections  will  describe 
how  to  select  test  data  and  test  programs. 

We  will  not  do  much  more  than  describe  the  purposes  of  most  of  the  debugging  tools. 
There  is  very  little  standardization  in  this  area,  and  not  enough  space  to  discuss  all  the 
devices  and  programs  that  are  currently  available.  The  examples  should  give  you  some 
idea  of  the  uses,  advantages,  and  limitations  of  particular  hardware  or  software  aids. 

SIMPLE  DEBUGGING  TOOLS 

The  simplest  debugging  tools  available  are: 

•  A  single-step  facility 

•  A  breakpoint  facility 

•  A  Register  Dump  program  (or  utility) 

•  A  Memory  Dump  program 

The  single-step  facility  allows  you  to  execute  the  program  one 
step  at  a  time.  Most  Z80-based  microcomputers  have  this  facility, 
since  the  circuitry  is  fairly  simple.  Of  course,  the  only  things  that 
you  will  be  able  to  see  when  the  computer  executes  a  single-step  are  the  states 
of  the  output  lines  that  you  are  monitoring.  The  most  important  lines  are: 

•  Data  Bus 

•  Address  Bus 

•  Control  lines  MREQ  (Memory  Request),  lORQ  (Input/Output  Request).  RD  (Memory 
Read),  and  WR  (Memory  Write). 

If  you  monitor  these  lines  (either  in  hardware  or  in  software),  you  will  be  able  to 
see  the  progression  of  addresses,  instructions,  and  data  as  the  program  executes. 
You  will  be  able  to  tell  what  kind  of  operations  the  CPU  is  performing.  This  infor- 
mation will  inform  you  of  such  errors  as  incorrect  Jump  instructions,  omitted  or  incor- 
rect addresses,  erroneous  operation  codes,  or  incorrect  data  values.  However,  you  can- 
not see  the  contents  of  registers  and  flags  without  some  additional  debugging  facility 
or  a  special  sequence  of  instructions.  Many  of  the  operations  of  the  program  cannot  be 
checked  in  real  time. 
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Table  14-1,  Z80  Restart  and  Interrupt  Addresses 


Instruction  or  External  Input 
(Mnemonic)  (Pin) 

Instruction  Obiect  Code 
(Hex) 

Destination  Address 
(Hex) 

RST  OOH 

C7 

0000 

RST  08H 

CF 

0008 

RST  10H 

D7 

0010 

RST  18H 

DF 

0018 

RST  20H 

E7 

0020 

RST  28H 

EF 

0028 

RST  30H 

F7 

0030 

RST  38H  or  INT  in  Mode  1 

FF 

0038 

NMI 

0066 

LIMITATIONS 
OF  SINGLE- 
STEP  MODE 


I  breakpoint! 


There  are  many  errors  that  a  single-step  nnode  cannot  help  vou 
to  find.  These  include  timing  errors  and  errors  in  the  interrupt 
or  DMA  systems.  Furthermore,  the  single-step  mode  is  very 
slow,  typically  executing  a  program  at  less  than  one  millionth 
of  the  speed  of  the  processor  itself.  To  single-step  through  one  second  of  real  processor 
time  would  take  more  than  ten  days.  The  single-step  mode  is  useful  only  to  check  the 
logic  of  short  instruction  sequences. 

A  breakpoint  Is  a  place  at  which  the  program  will  automat- 
ically halt  or  wait  so  that  the  user  can  examine  the  current 
status  of  the  system.  The  program  will  usually  not  start  again  until  the  operator  re- 
quests a  resumption  of  execution.  Breakpoints  allow  you  to  check  or  pass  through  an 
entire  section  of  a  program.  Thus,  to  see  if  an  initialization  routine  is  correct,  you  can 
place  a  breakpoint  at  the  end  of  it  and  run  the  program.  You  can  then  check  memory 
locations  and  registers  to  see  if  the  entire  section  is  correct.  However,  note  that  if  the 
section  IS  not  correct,  you'll  still  have  to  pin  down  the  error,  either  with  earlier  break- 
points or  With  a  single-step  mode. 

Breakpoints  complement  the  single-step  mode.  You  can  use  breakpoints  either  to 
localize  the  error  or  to  pass  through  sections  that  you  know  are  correct.  You  can 
then  do  the  detailed  debugging  in  the  single-step  mode.  In  some  cases,  breakpoints 
do  not  affect  program  timing;  they  can  then  be  used  to  check  input/output  interrupts. 

Breakpoints  often  use  part  or  all  of  the  microprocessor  interrupt 
system.  Some  microprocessors  have  a  special  SOFTWARE  INTER- 
RUPT or  TRAP  facility  that  can  act  as  a  breakpoint.  On  the  Z80,  if 
you  are  not  already  using  all  the  RST  vectors  in  your  program,  you  can  use  the  RST 
(Restart)  instruction  as  a  breakpoint.  Table  14-1  gives  the  destination  addresses  for 
the  various  RST  instructions.  Chapter  12  describes  the  RST  instruction  in  more  detail. 
The  breakpoint  routine  can  print  register  and  memory  contents  or  just  wait  (e.g..  ex- 
ecute HALT  or  a  conditional  jump  dependent  on  a  switch  input)  until  you  allow  the 
computer  to  proceed.  If  you  are  not  using  the  maskable  interrupt  (INT)  or  the  non- 
maskable interrupt  (NMI)  in  your  system,  you  can  use  those  vectors  as  externally  con- 
trolled breakpoints.  But  remember  that  the  interrupts  (including  NMI)  and  RST  use  the 
Stack  and  Stack  Pointer  to  store  the  return  address.  Figure  14-1  shows  a  routine  where 
RST  results  in  an  endless  loop.  You  would  have  to  clear  this  breakpoint  with  a  RESET  or 
interrupt  signal. 


RST  AS  A 
BREAKPOINT 
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Figure  14-1.  A  Simple  Breakpoint  Routine 


ORG 

18H 

RST18 

EQU 

18H 

JR 

RST18 

■.WAIT  IN  PLACE 

The  simplest  method  for  inserting  breakpoints  is  to  replace  the  first  byte  of  the  in- 
struction with  a  RST  instruction  or  to  replace  the  instruction  with  a  Jump  or  CALL 
instruction.  Use  of  a  RST  instruction  is  preferred  on  the  Z80,  since  it  involves  the 
replacement  of  only  a  single  byte,  whereas  a  JP  or  CALL  involves  three  bytes.  The  JR 
instruction  is  not  suitable  for  breakpointing  because  you  cannot  guarantee  that  the 
debug  software  is  within  -126  to  -H29  bytes  of  the  instruction  being  breakpointed. 
Multiple-byte  instructions  used  to  implement  breakpoints  can  cause  problems  on  the 
Z80  due  to  the  presence  of  single-byte  instructions.  To  illustrate  this  program,  examine 
the  program  segment  shown  below: 


Memory  Address 
(Hex) 

Memory  Contents 
(Hex) 

Instruction 
(Mnemonic) 

100 

7B 

LD 

A.E 

101 

87 

LI; 

ADD 

A.  A 

102 

87 

L2: 

ADD 

A,A 

If  you  wish  to  set  a  breakpoint  at  location  1 0Oi  6  using  a  3-byte  CALL  or  JP.  the  code  at 
locations  101  ig  and  102ig  will  also  get  overlaid  by  the  CALL  or  JP  instruction.  This 
means  that  the  debugger  has  to  be  aware  that  these  locations  have  also  been  modified. 
Any  transfers  of  control  to  LI  or  L2  while  the  breakpoint  is  set  will  produce  unexpected 
results  unless  the  debugger  is  designed  to  catch  this  case.  This  added  complexity  can 
be  avoided  by  using  a  RST  instruction. 

Many  monitors  have  facilities  for  inserting  and  removing  INSERTING 
breakpoints  implemented  via  some  type  of  Jump  instruction.  BREAKPOINTS 

Such  breakpoints  do  not  affect  the  timing  of  the  program  until 

the  breakpoint  is  executed.  However,  note  that  this  procedure  will  not  work  if  part  or  all 
of  the  program  is  in  ROM  or  PROM.  Other  monitors  implement  breakpoints  by  actually 
checking  the  address  lines  or  the  Program  Counter  in  hardware  or  in  software.  This 
method  allows  breakpoints  on  addresses  in  ROM  or  PROM,  but  it  may  affect  the  timing 
if  the  address  must  be  checked  in  software.  A  more  powerful  facility  would  allow  the 
user  to  enter  an  address  to  which  the  processor  would  transfer  control.  Another 
possibility  would  be  a  return  dependent  on  a  switch: 


ORG 

18H 

RST18 

EQU 

18H 

PUSH 

AF 

:SAVE  ACCUMULATOR,  FLAGS 

WAITS. 

IN 

A,(PIODRA) 

:GET  SWITCH  DATA 

BIT 

SW.A 

:IS  SWITCH  CLOSED' 

JR 

NZ,WAITS 

:N0,  WAIT  UNTIL  IT  IS 

POP 

AF 

:REST0RE  ACCUMULATOR.  FLAGS 

RET 

Remember  to  re-enable  the  interrupts  if  the  routine  uses  an  external  interrupt  input. 
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CHID 


Store  aii  rsgistet^ 

in  Stack 
COUhTT  =  Number  of 
bytes  in  register  =  22 
Data  Pointer  = 
Stack  Pointer  +  20 


Store  Data  Pointer 
m  Stack 


Data  Pointer  = 
Data  Pointer  -  1 


Print  (Data  Pointer) 

as  2  hex  digits 
COUNT  =  COUNT  -t 


Restore  all  registers 
from  Stack 


C 


Figure  14-2.  Flowchart  of  Register  Dump  Program 


A  Register  Dump  utility  on  a  microcomputer  is  a  program  that  REGISTER 
lists  the  contents  of  all  the  CPU  registers.  This  information  is  DUMPS 

usually  not  directly  obtainable.  The  following  routine  will  print 
the  contents  of  all  the  registers  on  the  system  printer,  if  we  assume  that  PRTHEX 
prints  the  contents  of  the  Accumulator  as  two  hexadecimal  digits.  Figure  14-2  is  a 
flowchart  of  the  program  and  Figure  14-3  shows  a  typical  result.  We  assume  that  the 
routine  is  entered  with  a  CALL  instruction  that  stores  the  old  Program  Counter  at  the 
top  of  the  Stack. 
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PLACE  ALL  CPU  REGISTER  CONTENTS  IN  STACK  (PC  ALREADY  ON  STACK) 


PUSH 

AF 

;SAVE  REGULAR  USER  REGISTERS 

PUSH 

BC 

PUSH 

DE 

PUSH 

HL 

PUSH 

IX 

;SAVE  INDEX  REGISTERS 

PUSH 

lY 

EX 

AF,AF 

■.ACCESS  AND  SAVE  PRIMED  CPU  REGISTERS 

EXX 

PUSH 

AF 

PUSH 

BC 

PUSH 

DE 

PUSH 

HL 

;  USE  STACK  POINTER  AS  STARTING  ADDRESS 

LD 

HL.O 

:GET  STACK  POINTER 

ADD 

HL.SP 

LD 

DE.20 

;COMPUTE  ORIGINAL  STACK  POINTER 

ADD 

HL.DE 

PUSH 

HL 

;SAVE  ORIGINAL  STACK  POINTER  IN  STACK 

,  PRINT  CONTENTS  OF  REGISTERS 

:  ORDER  IS  PC(HIGH),PC(LOWj,A,F.B.C,D,E.H.L,IX(HIGHj,IX(LOW),IY(HIGH), 

;  IY(LOW),A',F'. 

B-,C',D',E',H-,L'.SP(HIGH),SP(LOW) 

LD 

B.22 

;NUMBER  OF  BYTES  =  22 

PRNT1:  DEC 

HL 

LD 

A,(HL) 

:GET  A  BYTE  FROM  STACK 

CALL 

PRTHEX 

:AND  PRINT  IT 

DJNZ 

PRNT1 

.  RESTORE  REGISTERS  FROM  STACK 


POP 

HL 

POP 

HL 

POP 

DE 

POP 

BC 

POP 

AF 

EX 

AF.AF 

EXX 

POP 

lY 

POP 

IX 

POP 

HL 

POP 

DE 

POP 

BC 

POP 

AF 

RET 

:POP  AND  DISCARD  ORIGINAL  STACK  POINTER 
:RESTORE  PRIMED  CPU  REGISTERS 


•.RESTORE  INDEX  REGISTERS 
;RESTORE  REGULAR  CPU  REGISTERS 
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ID 

(A) 

42 

(F) 

07 

(B) 

3E 

(C) 

23 

(D) 

01 

(E) 

17 

(H) 

01 

!U 

D3 

(IX) 

58 

E2 

(lYS 

A2 

36 

(A') 

67 

(F') 

E8 

(B') 

11 

(C) 

EB 

(D1 

09 

(E'l 

D7 

(HI 

66 

(LI 

68 

(STACK  POINTER) 

E2 

Figure  14-3  Results  of  a  Typical  Z80  Register  Dump 
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A  Memory  Dump  is  a  program  that  lists  the  contents  of  memo-  MEIVIORY 
ry  on  an  output  device  (such  as  a  printer).  This  is  a  much  more  DUMP 
efficient  way  to  examine  data  arrays  or  entire  programs  than  |ust 
looking  at  single  locations.  However,  very  large  memory  dumps  are  not  useful  (except 
to  supply  scrap  paper)  because  of  the  sheer  mass  of  information  that  they  produce. 
They  may  also  take  a  long  time  to  execute  on  a  slow/  printer.  Small  dumps  may, 
however,  provide  the  programmer  with  a  reasonable  amount  of  information  that 
can  be  examined  as  a  unit.  Relationships  such  as  regular  repetitions  of  data  pat- 
terns or  offsets  of  entire  arrays  may  become  obvious. 

A  general  dump  is  often  rather  difficult  to  write.  The  programmer  should  be  careful  of 
the  following  situations: 

II  The  size  of  the  memory  area  exceeds  256  bytes,  so  that  an  8-bit  counter  will  not 
suffice. 

2)  The  ending  location  is  an  address  smaller  than  the  starting  location.  This  can  be 
treated  as  an  error,  or  simply  cause  no  output,  since  the  user  would  seldom  want  to 
print  the  entire  memory  contents  in  an  unusual  order. 

Since  the  speed  of  the  Memory  Dump  depends  on  the  speed  of  the  output  device,  the 
efficiency  of  the  routine  seldom  matters.  The  following  program  will  ignore  cases 
where  the  starting  address  is  larger  than  the  ending  address,  and  will  handle 
blocks  of  any  length.  We  assume  that  the  starting  address  is  In  Register  Pair  DE  and 
the  ending  address  is  in  Register  Pair  HL. 

;  STOP  IF  ENDING  .ADDRESS  BEFORE  STARTING  ADDRESS 


AND 
SBC 
JR 

XCHG 
INC 


A 

HL.DE 
C.DONE 

DE 


■.CLEAR  CARRY 

IS  ENDING  ADDRESS  BEFORE  STARTING? 
YES.  DO  NOT  DUMP  ANYTHING 
GET  STARTING  ADDRESS  INTO  HL 
COUNT  =  NUMBER  OF  LOCATIONS  TO  BE 
DUMPED 


PRINT  CONTENTS  OF  LOCATIONS 


DUMP;  LD 


CALL 

INC 

DEC 

LD 

OR 

JR 


A.(HL) 

PRTHEX 

HL 

DE 

A.E 

D 

NZ.DUMP 


;GET  CONTENTS  OF  A  LOCATION 
:AND  PRINT  IT 

:ALL  LOCATIONS  DUMPED? 
;N0.  CONTINUE  DUMPING 


DONE:  HALT 

Note  that  the  only  1 6-bit  Subtract  instruction  is  SBC.  which  subtracts  the  contents  of  a 
register  pair  and  the  Carry  from  Register  Pair  HL.  SBC.  like  other  Subtract  instructions, 
sets  the  Carry  if  a  borrow  is  required  (contrary  to  what  some  Z80  manuals  say). 

Figure  14-4  shows  the  output  from  a  dump  of  memory  locations  1000  to  101 F. 
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23 

IF 

60 

54 

37 

28 

3E 

00 

6E 

42 

38 

17 

59 

44 

98 

37 

47 

36 

23 

81 

El 

FF 

FF 

5A 

34 

ED 

BC 

AF 

FE 

FF 

27 

02 

Figure  14-4.  Results  of  a  Typical  Memory  Dump 


This  routine  correctly  handles  the  case  in  which  the  starting  and  ending  locations  are 
the  same  (try  it!).  You  will  have  to  interpret  the  results  carefully  if  the  dump  area 
includes  the  Stack,  since  the  dump  subroutine  itself  uses  the  Stack.  PRTHEX  may  also 
change  memory  and  Stack  locations. 

In  a  memory  dump,  the  data  can  be  displayed  in  a  number  of  different  ways.  Common 
forms  are  ASCII  characters  or  pairs  of  hexadecimal  digits  lor8-bit  values  and  four  hex- 
adecimal digits  for  16-bit  values.  The  format  should  be  chosen  based  on  the  intended 
use  of  the  dump.  It  is  almost  always  easier  to  interpret  an  object  code  dump  if  it  is  dis- 
played in  hexadecimal  form  rather  than  ASCII  form. 

A  common  and  useful  dump  format  is  illustrated  here: 

1000  54  68  65  20  64  75  6D  70         The  dump 

Each  line  consists  of  three  parts.  The  line  starts  with  the  hexadecimal  address  of  the 
first  byte  displayed  on  the  line.  Following  the  address  are  eight  or  sixteen  bytes  dis- 
played in  hexadecimal  form.  Last  is  the  ASCII  representation  of  the  same  eight  or  six- 
teen bytes.  Try  rewriting  the  memory  dump  program  so  that  it  will  print  the  address  and 
the  ASCII  characters  as  well  as  the  hexadecimal  form  of  the  memory  contents. 

MORE  ADVANCED  DEBUGGING  TOOLS 

The  more  advanced  debugging  tools  that  are  most  widely  used  are: 

•  Similar  programs  to  check  software 

■  Logic  analyzers  to  check  signals  and  timing 

Many  variations  of  both  these  tools  exist,  and  we  shall  discuss  only  the  standard 
features. 

The  simulator  is  the  computerized  equivalent  of  the  pencil-and- 
paper  computer.  It  is  a  computer  program  that  goes  through  the 
operating  cycle  of  another  computer,  keeping  track  of  the  con- 
tents of  all  the  registers,  flags,  and  memory  locations.  We  could,  of  course,  do  this 
by  hand,  but  it  would  require  a  large  amount  of  effort  and  close  attention  to  the  exact 
effects  of  each  instruction.  The  simulator  program  never  gets  tired  or  confused,  forgets 
an  instruction  or  register,  or  runs  out  of  paper. 

Most  simulators  are  large  FORTRAN  programs.  They  can  be  purchased  or  used  on  the 
time-sharing  services.  The  Z80  simulator  is  available  in  several  versions  from  different 
sources. 


I  SOFTWARE 
SIMULATOR! 
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Typical  simulator  features  are: 

1)  A  breakpoint  facility.  Usually,  breakpoints  can  be  set  after  a  particular  number  of 
cycles  have  been  executed,  vs/hen  a  memory  location  or  one  of  a  set  of  memory 
locations  is  referenced,  when  the  contents  of  a  location  or  one  of  a  set  of  locations 
are  altered,  or  on  other  conditions. 

2)  Register  and  memory  dump  facilities  that  can  display  the  values  of  memory  loca- 
tions, registers,  and  I/O  ports. 

3)  A  trace  facility  that  will  print  the  contents  of  particular  registers  or  memory  loca- 
tions whenever  the  program  changes  or  uses  them. 

4)  A  load  facility  that  allows  you  to  set  values  initially  or  change  them  during  the 
simulation. 

Some  simulators  can  also  simulate  input/output,  interrupts,  and  even  DMA. 
The  simulator  has  many  advantages: 

1)  It  can  provide  a  complete  description  of  the  status  of  the  computer,  since  the 
simulator  program  is  not  restricted  by  pin  limitations  or  other  characteristics  of  the 
underlying  circuitry. 

2)  It  can  provide  breakpoints,  dumps,  traces,  and  other  facilities,  without  using  any  of 
the  processor's  memory  space  or  control  system.  These  facilities  will  therefore  not 
interfere  with  the  user  program. 

3)  Programs,  starting  points,  and  other  conditions  are  easy  to  change. 

4)  All  the  facilities  of  a  large  computer,  including  peripherals  and  software,  are  availa- 
ble to  the  microprocessor  designer. 

On  the  other  hand,  the  simulator  is  limited  by  its  software  base  and  its  separation 
from  the  real  microcomputer.  The  major  limitations  are: 

1)  The  simulator  cannot  help  with  timing  problems,  since  it  operates  far  more  slowly 
than  real  time  and  does  not  model  actual  hardware  or  interfaces. 

2)  The  simulator  cannot  fully  model  the  input/output  section. 

3)  The  simulator  is  usually  quite  slow.  Reproducing  one  second  of  actual  processor 
time  may  require  hours  of  computer  time.  Using  the  simulator  can  be  quite  expen- 
sive. 

The  simulator  represents  the  software  side  of  debugging;  it  has  the  typical  ad- 
vantages and  limitations  of  a  wholly  software-based  approach.  The  simulator  can 
provide  insight  into  program  logic  and  other  software  problems,  but  cannot  help 
with  timing,  I/O,  and  other  hardware  problems. 

The  logic  or  microprocessor  analyzer  is  the  hardware  solution 
to  debugging.  Basically,  the  analyzer  is  the  parallel  digital  ver- 
sion of  the  standard  oscilloscope.  The  analyzer  displays  informa- 
tion in  binary,  hexadecimal  or  mnemonic  form  on  a  CRT,  and  has  a  variety  of  tnggering 
events,  thresholds,  and  inputs.  Most  analyzers  also  have  a  memory  so  that  they  can  dis- 
play the  past  contents  of  the  busses. 

The  standard  procedure  is  to  set  a  triggering  event,  such  as  the  occurrence  of  a  particu- 
lar address  on  the  Address  Bus  or  instruction  on  the  Data  Bus.  For  example,  one  might 
trigger  the  analyzer  if  the  microcomputer  tries  to  store  data  in  a  particular  address  or  ex- 
ecute an  input  or  output  instruction.  One  may  then  look  at  the  sequence  of  events  that 
preceded  the  breakpoint.  Common  problems  you  can  find  in  this  way  include  short 
noise  spikes  (or  glitches),  incorrect  signal  sequences,  overlapping  wave-forms, 
and  other  timing  or  signaling  errors.  Of  course,  a  software  simulator  could  not  be 
used  to  diagnose  those  errors  any  more  than  a  logic  analyzer  could  conveniently 
be  used  to  find  errors  in  program  logic. 


LOGIC 
ANALYZER 
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Logic  analyzers  vary  in  many  respects.  Some  of  these  are: 

1)    Number  of  input  lines.  At  least  24  are  necessary  to  monitor 


IMPORTANT 
FEATURES 
OF  LOGIC 
ANALYZERS 


an  8-bit  Data  Bus  and  a  16-bit  Address  Bus,  Still  more  are 
necessary  for  control  signals,  clocks,  and  other  important  in- 
puts. 

2)  Amount  of  memory.  Each  previous  state  that  is  saved  will  occupy  several  bytes. 

3)  Maximum  frequency.  It  must  be  several  MHz  to  handle  the  fastest  processors. 

4)  Minimum  signal  width  (important  for  catching  glitches). 

5)  Type  and  number  of  triggering  events  allowed.  Important  features  are  pre-  and 
post-trigger  delays;  these  allow  the  user  to  display  events  occurring  before  or 
after  the  trigger  event. 

6)  Methods  of  connecting  to  the  microcomputer.  This  may  require  a  rather  complex 
interface. 

7)  Number  of  display  channels. 

8)  Binary,  hexadecimal  or  mnemonic  displays. 

9)  Display  formats. 

10)  Signal  hold  time  requirements. 

1 1)  Probe  capacitance. 

12)  Single  or  dual  thresholds. 

All  of  these  factors  are  important  in  comparing  different  logic  and  microprocessor 
analyzers,  since  these  instruments  are  new  and  unstandardized.  .A  tremendous  variety 
of  products  IS  already  available  and  this  variety  will  become  even  greater  in  the  future. 

Logic  analyzers,  of  course,  are  necessary  only  for  systems  with  complex  timing. 
Simple  applications  with  low-speed  peripherals  have  few  hardware  problems  that 
a  designer  cannot  handle  with  a  standard  oscilloscope. 

DEBUGGING  WITH  CHECKLISTS 

The  designer  cannot  possiblv  check  an  entire  program  bv  hand:  however,  there  are 
certain  trouble  spots  that  the  designer  can  easily  check.  You  can  use  systematic  hand 
checking  to  find  a  large  number  of  errors  without  resorting  to  any  debugging  tools. 


The  question  is  where  to  place  the  effort.  The  answer  is  on       I  WHAT  TO 
points  that  can  be  handled  with  either  a  yes-no  answer  or  with       I  INCLUDE  IN 
a  simple  arithmetic  calculation.  Do  not  try  to  do  complex        |  CHECKLIST 
arithmetic,  follow  all  the  flags,  or  try  every  conceivable  case.  Limit 
your  hand  checking  to  matters  that  can  be  settled  easily.  Leave  the  complex  problems 
to  be  solved  with  the  aid  of  debugging  tools.  But  proceed  systematically:  build  your 

checklist,  and  make  sure  that  the  program  performs  the  basic  operations  correctly. 

The  first  step  is  to  compare  the  flowchart  or  other  program  documentation  with 
the  actual  code.  Make  sure  that  evervthing  that  appears  in  one  also  appears  in  the 
other.  A  simple  checklist  will  do  the  |ob.  It  is  easy  to  completely  omit  a  branch  or  a  pro- 
cessing section. 

Next  concentrate  on  the  program  loops.  Make  sure  that  all  registers  and  memory 
locations  used  inside  the  loops  are  initialized  correctly.  This  is  a  common  source  of  er- 
rors; once  again,  a  simple  checklist  will  suffice. 

Now  look  at  each  conditional  branch.  Select  a  sample  case  that  should  produce  a 
branch  and  one  that  should  not;  try  both  of  them.  Is  the  branch  correct  or  reversed?  If 
the  branch  involves  checking  whether  a  number  is  above  or  below  a  threshold,  try  the 
equality  case.  Does  the  correct  branch  occur'  Make  sure  that  your  choice  is  consistent 
with  the  problem  definition. 
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Look  at  the  loops  as  a  whole.  Try  the  first  and  last  iterations  by  hand:  these  are  often 
troublesome  special  cases.  What  happens  if  the  number  of  iterations  is  zero;  i.e..  there 
IS  no  data  or  the  table  has  no  elements?  Does  the  program  fall  through  correctly?  Pro- 
grams often  will  perform  one  iteration  unnecessarily,  or,  even  worse,  decrement  coun- 
ters past  zero  before  checking  them. 

Check  off  everything  down  to  the  last  statement.  Don't  assume  (hopefully)  that 
the  first  error  is  the  only  one  in  the  program.  Hand  checking  will  allow  you  to  get 
the  maximum  benefit  from  debugging  runs,  since  you  will  get  rid  of  many  simple 
errors  ahead  of  time. 

A  quick  reyiew  of  the  hand  checking  questions; 

1)  Is  every  element  of  the  program  design  in  the  program  (and 
vice  versa  for  documentation  purposes)' 

2)  Are  all  registers  and  memory  locations  used  inside  loops  in- 
itialized before  they  are  used? 

3)  Are  all  conditional  branches  correct? 

4)  Do  all  loops  start  and  end  properly' 

5)  Are  equality  cases  handled  correctly' 

6)  .Are  trivial  cases  handled  correctly' 

LOOKING  FOR  ERRORS 

Of  course,  despite  all  these  precautions  (or  if  you  skip  over 
some  of  them),  programs  often  still  don't  work.  The  designer 
is  left  with  the  problem  of  how  to  find  the  mistakes.  The  hand 
checklist  provides  a  starting  place  if  you  didn't  use  it  earlier;  some  of  the  errors 
that  you  may  not  have  eliminated  are: 

1)  Failure  to  initialize  variables  such  as  counters,  pointers,  sums,  etc.  Do  not 

assume  that  registers,  memory  locations,  or  flags  necessarily  contain  zero  before 
they  are  used. 

2)  Inverting  the  logic  of  a  conditional  Jump,  such  as  using  Jump  on  Carry  when  vou 
mean  Jump  on  Not  Carry.  Remember  the  effects  of  a  comparison  or  subtraction  (A 
IS  the  contents  of  the  Accumulator,  M  the  contents  of  the  register  or  memory  loca- 
tion): 

Zero  flag  =  1  if  .A  =  M 
=  0  if  A^M 
Carry  flag   =  1  if  A  <  tvl 
=  0  if  A  >  tVl 

Note  particularly  that  Carry  =  0  if  A  =  Ivl,  (the  equality  case).  So,  Jump  on  Carry 
means  jump  if  A  <  M,  and  Jump  on  Not  Carry  means  lump  if  A  >  M,  If  you  want 
the  equality  case  on  the  other  side,  try  either  reversing  the  roles  of  .A  and  M  or 
adding  1  to  IVt.  For  example,  if  you  want  a  |ump  if  A  >  10,  use: 

CP  10 

JR  NC.ADDR 

If,  on  the  other  hand,  you  want  a  |ump  if  A  >  10,  use: 

CP  11 

JR  NCADDR 

3)  Updating  the  counters  and  pointers  in  the  wrong  place  or  not  at  all.  Be  sure 
that  there  are  no  paths  through  a  loop  that  either  skip  or  repeat  the  updating  in- 
structions. 


HAND 

CHECKING 

QUESTIONS 


COMMON 
ERRORS 
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4)  Failure  to  fall  through  correctly  in  trivial  cases  such  as  no  data  in  a  buffer,  no 
tests  to  be  run,  or  no  entries  in  a  transaction.  Do  not  assume  that  such  cases  will 
never  occur  unless  the  program  specificallv  eliminates  them. 

Other  problems  to  watch  for  are: 

5)  Reversing  the  order  of  operands.  Remember  that  the  LD  instruction  moves  the 
second  operand  into  the  first  operand.  For  example.  LD  B,A  moves  the  contents  of 
A  to  B,  not  the  other  way  around. 

6)  Changing  condition  flags  before  you  use  them. 

Remember  that  INC  and  DEC,  when  applied  to  a  single  register  or  memory  loca- 
tion, affect  all  the  flags  except  Carry.  Remember  also  that  POP  AF  and  EX  AF.AF' 
affect  all  the  flags,  and  that  Logical  instructions  clear  the  Carry. 

7)  Failing  to  change  condition  flags  when  you  intend  to. 

The  Zero  and  Sign  flags  may  not  represent  the  current  state  of  the  Accumulator, 
since  many  instructions  (particularly  LD)  do  not  change  the  flags.  Note  that  incre- 
menting or  decrementing  register  pairs  (for  example,  INC  HL  or  DEC  SO  and  com- 
plementing the  Accumulator  (CPL)  affect  no  flags  at  all. 

8)  Confusing  values  and  addresses. 

Remember  that  LD  HL.IOOOH  loads  HL  with  the  number  1000  (hex)  while  LD 
HL,{1000Hj  loads  HL  with  the  contents  of  memory  locations  1000  and  1001.  A 
similar  distinction  applies  to  LD  A.COUNT  and  LD  A,(COUNT). 

9)  Accidentally  reinitializing  a  register  or  memory  location. 

Make  sure  that  no  Jump  instructions  transfer  control  back  to  initialization  state- 
ments. 

1 0)  Confusing  numbers  and  characters. 

Remember  that  the  ASCII  and  EBCDIC  representations  of  digits  differ  from  the 
digits  themselves.  For  example,  ASCII  7  is  hex  37,  whereas  hex  07  is  the  ASCII 
BELL  character. 

1 1 )  Confusing  binary  and  decimal  numbers. 

Remember  that  the  BCD  representation  of  a  number  differs  from  its  binary  repre- 
sentation. For  example,  BCD  36.  when  treated  as  a  simple  hexadecimal  constant, 
IS  equivalent  to  54  decimal  (try  it). 

1 2)  Reversing  the  order  in  subtraction.  Be  careful  also  with  other  operations  (like 
division)  that  do  not  commute.  Remember  that  SUB  and  CP  produce  A-M,  not 
M-A. 

1 3)  Ignoring  the  effects  of  subroutines  and  macros. 

Don't  assume  that  calls  to  subroutines  or  invocations  of  macros  will  not  change 
flags,  registers,  or  memory  locations.  Be  sure  of  exactly  what  effects  subroutines 
or  macros  have.  Note  that  it  is  very  important  to  document  these  effects  so  that 
the  user  can  determine  them  without  going  through  the  entire  listing. 

14)  Using  the  Shift  instructions  improperly. 

Remember  the  precise  effects  of  RLC,  RL,  RRC,  RR.  SLA,  SRA,  and  SRL.  They  are 
all  1-bit  shifts.  SLA  and  SRL  both  clear  the  empty  bit.  SRA  preserves  the  sign 
(most  significant  bit)  by  extending  it  to  the  right.  RLC  and  RRC  are  circular  shifts 
that  do  not  include  the  Carry  in  the  circular  register:  RL  and  RR  are  circular  shifts 
that  include  the  Carry.  Remember  that  these  instructions  affect  all  the  flags,  even 
if  they  are  applied  to  the  data  in  a  memory  location.  Note,  however,  that  the  one- 
word  shifts  RLCA,  RLA,  RRCA,  and  RRA  affect  only  the  Carry. 
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1 5)  Counting  the  length  of  an  array  incorrectly. 

Remember  that  there  are  five  (not  four)  memory  locations  included  in  addresses 
0100  tfirougfi  0104.  inclusive. 

1 6)  Confusing  registers  and  register  pairs. 

Remember  that  the  CPU  registers  and  register  pairs  are  physicallv  the  same.  You 
can  use  them  singly  for  8-bit  data  or  in  pairs  for  addresses  or  1 6-bit  data,  but  not 
both  at  the  same  time.  Note  that  INC  HL  actually  increments  L.  affecting  H  only  if 
L  IS  incremented  to  zero. 

17)  Confusing  8-  and  16-bit  registers. 

The  Accumulator  and  other  CPU  registers  are  eight  bits  long,  while  the  index 
registers.  Program  Counter,  Stack  Pointer,  and  register  pairs  are  16  bits  long.  You 
cannot  transfer  the  contents  of  a  1 6-bit  register  to  an  8-bit  register  or  vice  versa. 

18)  Forgetting  that  16-bit  numbers  or  addresses  occupy  two  memory  locations. 

LD  HL,(40H)  loads  Register  Pair  HL  with  the  contents  of  memory  locations  0040 
and  0041 .  Similarly,  PUSH  DE  stores  Register  Pair  DE  in  two  Stack  locations.  Also 
remember  that  the  Z80  stores  ail  2-byte  quantities  in  low-order/high-order  format. 
For  example.  LD  (40H),HL  will  store  the  contents  of  Register  L  in  location  0040 
and  the  contents  of  Register  H  in  location  0041. 

1 9)  Confusing  the  Stack  and  the  Stack  Pointer. 

DEC.  INC,  and  LD  affect  the  Stack  Pointer,  not  the  contents  of  the  Stack.  PUSH 
and  POP  transfer  data  to  or  from  the  Stack.  Remember  that  CALL.  RET.  RETI. 
RETN.  and  RST  also  use  the  Stack  to  save  or  restore  the  Program  Counter.  The 
response  to  an  interrupt  always  involves  saving  the  old  Program  Counter  in  the 
Stack  even  if  no  explicit  instruction  is  obtained  externally  (as  in  responding  to  NMI 
or  to  INT  in  interrupt  modes  1  or  2).  Note  that  such  instructions  as  EX  (SP).HL  do 
not  affect  the  Stack  Pointer;  they  exchange  the  top  two  memory  locations  in  the 
Stack  with  the  contents  of  a  register  pair  or  Index  register,  but  leave  the  Stack 
length  unchanged. 

20)  Forgetting  to  initialize  the  Stack  Pointer, 

Remember  that  you  must  place  the  proper  memory  address  into  the  Stack  Pointer 
before  calling  any  subroutines  or  performing  any  Stack  operations. 

21)  Changing  a  register  or  memory  location  before  using  it. 

Remember  that  LD  changes  the  contents  of  the  destination  (but  not  the  source). 
Be  careful  of  instructions  that  implicitly  use  certain  registers  —  for  example, 
DJNZ  decrements  Register  B;  LDI,  LOIR,  LDD.  LDDR,  CPI,  CPIR.  CPD,  and  CPDR 
all  decrement  the  Byte  Counter  in  Register  Pair  BC  and  increment  or  decrement 
Register  Pair  HL.  LDI,  LDIR.  LDD,  and  LDDR  also  increment  or  decrement  Register 
Pair  DE.  INI.  INIR.  IND.  INDR,  OUTI,  OUTIR.  OUTD.  and  OTDR  all  decrement 
Register  B  and  increment  or  decrement  Register  Pair  HL. 

22)  Forgetting  to  transfer  control  past  sections  of  the  program  that  should  not  be 
executed  in  particular  situations. 

Remember  that  the  computer  will  proceed  sequentially  through  the  program 
memory  unless  specifically  ordered  to  do  otherwise. 
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Interrupt-driven  programs  are  particularly  difficult  to  debug,  DEBUGGING 
since  errors  may  occur  randomly.  If.  for  example,  the  program  INTERRUPT- 
enables  the  interrupts  a  few  instructions  too  early,  an  error  will  oc-  DRIVEN 
cur  only  if  an  interrupt  is  received  while  the  program  is  executing       I  PROGRAMS 
those  few  instructions.  In  fact  you  can  usually  assume  that  ran- 
domly occurring  errors  are  caused  by  the  interrupt  system.^  Typical  errors  in  inter- 
rupt-driven programs  are: 

1 )  Forgetting  to  re-enable  interrupts  after  accepting  one  and  servicing  it. 

The  processor  disables  the  interrupt  system  automatically  on  RESET  or  on  accept- 
ing an  interrupt.  Be  sure  that  no  possible  sequences  fail  to  re-enable  the  interrupt 
system.  Remember  that,  in  addition  to  re-enabling  interrupts,  the  program  often 
has  to  perform  some  action  to  cause  the  interrupting  signal  to  be  reset.  If  this  is  not 
done,  it  will  appear  as  if  the  interrupting  device  is  constantly  requesting  service. 

2)  Using  the  Accumulator  before  saving  it;  i.e.,  PUSH  AF  must  precede  any  input 
or  output  operations  that, involve  the  .Accumulator. 

3)  Forgetting  to  save  and  restore  the  Accumulator  and  flags  (Register  Pair  AF). 

4)  Restoring  registers  in  the  wrong  order. 

If  the  order  in  which  they  were  saved  was: 

PUSH  AF 
PUSH  BC 
PUSH  DE 
PUSH  HL 

the  order  of  restoration  should  be: 

POP  HL 
POP  DE 
POP  BC 
POP  AF 

5)  Enabling  interrupts  before  establishing  all  the  necessary  conditions  such  as 
priority,  flags,  PIO  and  SIO  configurations,  pointers,  counters,  etc. 

A  checklist  can  aid  here. 

6)  Leaving  results  in  registers  and  destroying  them  in  the  restoration  process. 

As  noted  earlier,  registers  should  not  be  used  to  pass  information  between  the 
regular  program  and  the  interrupt  service  routines. 

7)  Forgetting  that  RST  {and  NMI)  leaves  an  address  in  the  Stack  whether  you 
use  it  or  not. 

You  may  have  to  re-mitialize  or  update  the  Stack  Pointer. 

8)  Not  disabling  the  interrupt  during  multi-word  transfers  or  instruction  se- 
quences. 

Watch  particularly  for  situations  where  the  interrupt  service  routine  may  use  the 
same  memory  locations  that  the  program  is  using. 

Hopefully,  these  lists  will  at  least  give  you  some  ideas  as  to  where  to  look  for  er- 
rors. Unfortunately,  even  the  most  systematic  debugging  can  still  leave  some 
truly  puzzling  problems,  particularly  when  interrupts  are  involved.^ 
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(41)  =  Result 

(     "  ) 


Figure  14-5.  Flowchart  of  Decimal  to  Seven-Segment  Conversion 
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Debugging  Example  1 :  Decimal  to  Seven-Segment  Conversion 

The  program  converts  a  decimal  number  in  memory  location  0040 
to  a  seven-segment  code  m  memory  location  0041.  It  blanks  the 
display  if  memory  location  0040  does  not  contain  a  decimal  num- 
ber. 

Initial  Program  (from  flowchart  m  Figure  14-5): 


DEBUGGING 
A  CODE 
CONVERSION 
PROGRAM 


DONE. 


SSEG. 


LD 

A,40H 

GET  DATA 

CP 

9 

IS  DATA  A  DECIMAL  DIGIT? 

JR 

CDONE 

NO,  KEEP  ERROR  CODE 

LD 

HL.iSSEG) 

GET  BASE  ADDRESS  OF  7-SEGMENT  TABLE 

LD 

D.A 

ADD 

HL.DE 

FIND  ELEMENT  BY  INDEXING 

LD 

A.iHU 

GET  7-SEGMENT  CODE  FROM  TABLE 

LD 

(41 H). A 

SAVE  7-SEGMENT  CODE  OR  ERROR  CODE 

HALT 

DEFB 

3FH 

DEFB 

06H 

DEFB 

5BH 

DEFB 

4FH 

DEFB 

66H 

DEFB 

6DH 

DEFB 

7DH 

DEFB 

07H 

DEFB 

7DH 

DEFB 

6FH 

Using  the  checklist  procedure,  we  were  able  to  find  the  following  errors: 

1)  The  block  that  cleared  Result  had  been  omitted. 

2)  The  conditional  branch  was  incorrect. 

For  example,  if  the  data  is  zero,  CP  9  sets  the  Carry,  since  0  <  9.  However,  the  iump  on 
the  opposite  condition  (i.e..  JR  NC.DONE)  still  did  not  produce  the  correct  result.  Now 
the  program  handles  the  equality  case  incorrectly  since,  if  the  data  is  9.  CP  9  clears  the 
Carry  and  causes  a  |ump.  The  correct  version  is: 

CP  10  ;IS  DATA  A  DECIMAL  DIGIT? 

JR  NCDONE      :N0,  KEEP  ERROR  CODE 
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Second  Program: 


DONE: 


SSEG; 


LD 

B,0 

GET  ERROR  CODE  TO  BLANK  DISPLAY 

LD 

A.40H 

GET  DATA 

CP 

10 

IS  DATA  A  DECIMAL  DIGIT? 

JR 

NCDONE 

NO,  KEEP  ERROR  CODE 

LD 

HL,(SSEG) 

GET  BASE  ADDRESS  OF  V-SEGMENT  TABLE 

LD 

D.A 

ADD 

HL.DE 

FIND  ELEMENT  BY  INDEXING 

LD 

A,(HL) 

GET  7-SEGMENT  CODE  FROM  TABLE 

LD 

(41H),A 

SAVE  7-SEGMENT  CODE  OR  ERROR  CODE 

HALT 

DEFB 

3FH 

DEFB 

06H 

DEFB 

5BH 

DEFB 

4FH 

DEFB 

66H 

DEFB 

6DH 

DEFB 

7DH 

DEFB 

07H 

DEFB 

7DH 

DEFB 

6FH 

This  version  was  hand  checked  successfullv. 

Since  the  program  was  simple,  the  next  stage  was  to  single-step  through  it  with  read 
data.  The  data  selected  for  the  trials  was: 

0  (the  smallest  number) 

9  (the  largest  number) 

10  (a  border  case) 

6B  (hex)  (random) 

The  first  trial  was  with  zero  in  location  0040  (hex).  The  first  error  was  obvious  —  LD 
A.40H  loaded  the  number  40  into  A.  not  the  contents  of  memory  location  0040.  The 
correct  instruction  was  LD  -A,(40H).  After  this  correction  was  made,  the  program  moved 
along  with  no  apparent  errors  until  it  tried  to  execute  the  LD  A.(HL)  instruction. 

The  contents  of  the  Address  Bus  during  the  data  fetch  was  0647.  an  address  thai  did 
not  even  exist  in  the  microcomputer.  Clearly,  something  had  gone  wrong. 

It  was  now  time  for  some  more  hand-checking  Since  we  knew  that  JR  NCDONE  was 
correct,  the  error  was  beyond  that  instruction  but  before  LD  A,(HL).  A  hand  check 
showed: 

1)  LD  HL,(SSEG)  places  3F  (hex)  into  L  and  06  (hex)  into  H. 

This  IS  clearly  wrong.  We  want  LD.  HL.SSEG.  not  LD  HL,(SSEG).  That  is.  we  want 
the  address  SSEG,  not  the  contents  of  that  address,  to  be  loaded  into  Register  Pair 
HL. 

2)  LD  D.A  places  0  into  Register  D. 

This  IS  wrong  —  the  data  should  be  placed  into  E.  since  we  want  to  add  it  to  the 
least  significant  bits  of  the  table  address.  In  fact,  an  instruction  should  clear 
Register  D.  since  the  erroneous  program  was  not  initializing  or  changing  the  other 
half  of  Register  Pair  DE  at  all. 
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Third  Program: 


LD 

LD 

CP 

JR 

LD 

LD 

LD 

ADD 

LD 


8,0 

A,(40H) 
10 

NCDONE 

HL.SSEG 

E.A 

D,0 

HLDE 

A,(HL) 

(41 H), A 


GET  ERROR  CODE  TO  BLANK  DISPLAY 
GET  DATA 

IS  DATA  A  DECIMAL  DIGIT? 

NO.  KEEP  ERROR  CODE 

GET  BASE  ADDRESS  OF  7-SEGMENT  TABLE 


DONE.  LD 


USE  DATA  AS  16-BIT  INDEX 

FIND  ELEMENT  BY  INDEXING 

GET  7-SEGMENT  CODE  FROM  TABLE 

SAVE  7-SEGMENT  CODE  OR  ERROR  CODE 


HALT 

SSEG.      DEFB  3FH 

DEFB  06H 

DEFB  5BH 

DEFB  4FH 

DEFB  66H 

DEFB  6DH 

DEFB  7DH 

DEFB  07H 

DEFB  7DH 

DEFB  6FH 

This  program  produced  the  following  results: 


The  program  was  not  clearing  the  result  if  the  data  was  invalid,  i.e..  greater  than  9.  The 
program  never  used  the  blank  code  in  Register  B.  Since  the  program  was  simple,  it 
could  be  tested  for  all  the  decimal  digits.  The  results  were: 


Note  that  the  result  for  number  8  is  wrong  —  it  should  be  7F  Since  everything  else  is 
correct,  the  error  is  almost  surely  in  the  table.  In  fact,  entry  8  in  the  table  had  been 
miscopied. 


Data  Result 
~00~  3F 
09  6F 

OA  OA 
6B  6B 


Data  Result 

0  3F 

1  06 

2  5B 

3  4F 

4  69 

5  6D 

6  7D 

7  07 

8  7D 

9  6F 


14-18 


The  final  program  is: 


DECIMAL  TO  7-SEGMENT  CONVERSION 


LD 

B.O 

GET  ERROR  CODE  TO  BLANK  DISPLAY 

LD 

A.(40H) 

GET  DATA 

CP 

10 

IS  DATA  A  DECIMAL  DIGIT? 

JR 

NCDONE 

NO.  KEEP  ERROR  CODE 

LD 

HL.SSEG 

GET  BASE  ADDRESS  OF  7-SEGMENT  TABLE 

LD 

E,A 

LD 

D.O 

USE  DATA  AS  16-BIT  INDEX 

ADD 

HL.DE 

FIND  ELEMENT  BY  INDEXING 

LD 

b.!hl) 

GET  7-SEGMENT  CODE  FROM  TABLE 

LD 

A,B 

LD 

(41H).A 

SAVE  7-SEGMENT  CODE  OR  ERROR  CODE 

HALT 

DEFB 

3FH 

DEFB 

06H 

DEFB 

5BH 

DEFB 

4FH 

DEFB 

66H 

DEFB 

6DH 

DEFB 

7DH 

DEFB 

07H 

DEFB 

7FH 

DEFB 

6FH 

The  errors  encountered  in  this  program  are  typical  of  the  ones  that  Z80  assembly 
language  programmers  should  anticipate.  They  include: 

1)  Failing  to  initialize  registers  or  memory  locations. 

2)  Inverting  the  logic  on  conditional  branches. 

3)  Branching  incorrectly  in  the  case  in  which  the  operands  are  equal. 

4)  Confusing  immediate  and  direct  addressing,  i.e.,  data  and  addresses. 

5)  Failing  to  distinguish  between  8-bit  data  and  16-bil  addresses. 

6)  Branching  to  the  wrong  place  so  that  one  path  through  the  program  is  incorrect. 

7)  Copying  lists  of  numbers  (or  instructions)  incorrectly. 

Note  that  straightforward  instructions  like  ADD.  SUB.  AND,  etc.,  seldom  produce  any 
problems.  One  particularly  annoying  error  that  you  should  watch  for  is  reversing  the 
operands  on  LD  instructions.  Many  of  these  errors  can  be  eliminated  through  the  use  of 
a  low-level  system  programming  language  like  PLZ/ASM.^ 
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Interchange  flag  =  1 
Count  =  UngtH 

of  Array] 
Pointer  =  Start 

of  Array 


Interchange  {Pointer! 

{Pointer  +  1) 
Interchange  flag  =  0 


Pointer  =  Pointer  +  1 
Count  =  Count  -  1 


Figure  14-6.  Flowchart  of  Sort  Program 
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Debugging  Example  2:  Sort  into  Decreasing  Order 

The  program  sorts  an  array  of  unsigned  8-bit  binary  numbers  into 
decreasing  order.  The  array  begins  in  memory  location  0041  and 
Its  length  is  in  memory  location  0040. 

Initial  Program  (from  flowchart  in  Figure  14-6): 


PASS1: 


DEBUGGING 
A  SORT 
PROGRAM 


LD 

CO 

:CLEAR  INTERCHANGE  FLAG 

LD 

A.(40H) 

■.COUNT  =  LENGTH  OF  ARRAY 

LD 

C.A 

LD 

HL,41H 

; POINT  TO  START  OF  ARRAY 

LD 

A.(HL) 

;GET  ELEMENT  FROM  ARRAY 

INC 

HL 

CP 

(HL) 

:IS  IT  LESS  THAN  NEXT  ELEMENT? 

JR 

C.CNT 

:N0,  NO  INTERCHANGE  NECESSARY 

LD 

(HU.A 

;YES,  INTERCHANGE  ELEMENTS 

INC 

HL 

DJNZ 

PASS1 

DEC 

C 

;WAS  INTERCHANGE  FLAG  SET? 

JR 

NZ.PASSI 

:YES.  DO  ANOTHER  PASS 

HALT 

CNT 


The  hand  check  shows  that  all  the  blocks  in  the  flowchart  have  been  implemented  m 
the  program  and  that  all  the  registers  have  been  initialized.  The  conditional  branches 
must  be  examined  carefully.  The  instruction  JR  C.CNT  must  force  a  branch  if  the  new 
value  IS  less  than  or  equal  to  the  old  value.  Note  that  the  equality  case  must  not  result  m 
an  interchange,  since  this  will  create  an  endless  loop  with  the  two  equal  elements 
being  switched  back  and  forth. 


Try  an  example: 


(0040)  = 

(0041)  = 


30 
37 


CP  (HL)  results  in  the  calculation  of  30—37  The  Carry  is  set  to  one.  This  example 
should  result  m  an  interchange  but  does  not. 

JR  NC.CNT  will  provide  the  proper  branch  in  this  case,  if  the  two  numbers  are  equal, 
the  comparison  will  clear  the  Carry  and  JR  NC.CNT  is  again  correct. 

How  about  JR  NZ.SORT  at  the  end  of  the  program?  If  there  are  any  elements  out  of 
order,  the  interchange  flag  will  be  one.  so  the  branch  is  wrong.  It  should  be  JR  Z.SORT. 

Now  let's  hand  check  the  first  iteration  of  the  program.  The  initialization  results  in  the 
following  values: 

A  =  COUNT 
B  =  COUNT 
C  =  0 
HL  =  0041 

The  effects  of  the  loop  instructions  are: 


CNT: 


LD 

A,(HL) 

:A  =  (0041) 

INC 

HL 

:HL  =0042 

CP 

(HL) 

:(0041)-(0042) 

JR 

NC.CNT 

LD 

(HL).A 

:(0042)  =  (0041 

INC 

HL 

:HL  =  0043 

DJNZ 

PASS1 

;B  =  C0UNT-1 
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Note  that  we  have  already  checked  the  Conditional  Jump  instructions.  Clearly  the  logic 
is  incorrect.  It  the  first  two  nunnbers  are  out  of  order,  the  results  after  the  first  iteration 
should  be: 

(0041)  =  OLD  (0042) 

(0042)  =  OLD  (0041) 
HL  =  0042 

B  =  COUNT- 1 

Instead,  they  are: 

(0041)  =  UNCHANGED 

(0042)  =  OLD  (0041) 
HL  =  0043 

B  =  COUNT-1 

The  error  in  HL  is  easy  to  correct.  The  second  INC  HL  is  unnecessary  and  should  be 
omitted.  The  interchange  requires  a  bit  more  care  and  a  temporary  register,  i.e., 

LD  D.(HL) 
LD  (HU,A 
DEC  HL 
LD  (HL),D 
INC  HL 

An  interchange  always  requires  a  temporary  storage  place  in  which  one  number  can  be 
saved  while  the  other  one  is  being  transferred. 
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All  of  these  changes  require  a  new  copy  of  the  program,  i.e.. 


PASS1: 


LD 

CO 

;CLEAR  INTERCHANGE  FLAG 

LD 

A.!40H) 

iCOUNT  =  LENGTH  OF  ARRAY 

LD 

C.A 

LD 

HL.41  H 

IPOINT  TO  START  OF  ARRAY 

LD 

A,(HL) 

:GET  ELEMENT  FROM  ARRAY 

INC 

HL 

CP 

(HL) 

•.IS  IT  LESS  THAN  NEXT  ELEMENT? 

JR 

NCCNT 

;N0.  NO  INTERCHANGE  NECESSARY 

LD 

D,(HLi 

;YES,  INTERCHANGE  ELEMENTS 

LD 

(HU.A 

DEC 

HL 

LD 

(HU.D 

INC 

HL 

DJNZ 

PASS1 

DEC 

C 

:WAS  INTERCHANGE  FLAG  SET? 

JR 

NZ.PASSI 

:.YES,  DO  ANOTHER  PASS 

HALT 

CNT; 


How  about  the  last  iteration?  Let's  say  that  there  are  three  elements: 

(0040)  =  03 

(0041)  =  02 

(0042)  =  04 

(0043)  =  06 

Each  time  through,  the  program  increments  Register  Pair  HL  bv  one.  So.  at  the  start  of 
the  third  iteration. 

(HL)  =  0041  +  2  =  0043 

The  effects  of  the  loop  instructions  are: 

LD  A.(HL)  :A  =  (0043) 

INC  HL  :HL=0044 

CP  (HL)  :(0043)-(0044) 

This  IS  incorrect;  the  program  has  tried  to  move  beyond  the  end  of  the  data.  The  pre- 
vious Iteration  should,  in  fact,  have  been  the  last  one.  since  the  number  of  pairs  is  one 
less  than  the  number  of  elements.  The  correction  is  to  reduce  the  number  of  iterations 
by  one;  this  can  be  accomplished  by  placing  DEC  B  after  LD  A,(40H). 

How  about  the  trivial  cases?  What  happens  if  the  array  contains  no  elements  at 
all,  or  only  one  element?  The  answer  is  that  the  program  does  not  work  correctly 
and  may  change  a  whole  block  of  data  improperly  and  without  any  warning  (try 
iti).  The  corrections  to  handle  the  trivial  cases  are  simple  but  essential;  the  cost 
is  only  a  few  bytes  of  memory  to  avoid  problems  that  could  be  very  difficult  to 
solve  later. 
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The  new  program  is: 


PASS1; 


CNT: 


LD 

CO 

CLEAR  INTERCHANGE  FLAG 

LD 

A,(40H) 

COUNT  =  LENGTH  OF  ARRAY 

CP 

2 

DOES  ARRAY  HAVE  2  OR  MORE  ELEMENTS? 

JR 

CDONE 

NO,  NO  ACTION  NECESSARY 

LD 

B.A 

DEC 

B 

NUMBER  OF  PAIRS  =  COUNT-1 

LD 

HL,41H 

POINT  TO  START  OF  ARRAY 

LD 

A,(HL) 

GET  ELEMENT  FROM  ARRAY 

INC 

HL 

CP 

(HL) 

IS  IT  LESS  THAN  NEXT  ELEMENT? 

JR 

NC.CNT 

NO.  NO  INTERCHANGE  NECESSARY 

LD 

D.(HL) 

YES,  INTERCHANGE  ELEMENTS 

LD 

(HLi.A 

DEC 

HL 

LD 

(HU.D 

INC 

HL 

DJNZ 

PASS1 

DEC 

C 

WAS  INTERCHANGE  FLAG  SET' 

JR 

NZ.PASS1 

YES,  DO  ANOTHER  PASS 

HALT 

Now  It's  time  to  check  the  program  on  the  computer  or  on  the  simulator.  A  simple  set  of 
data  is; 

(0040)  =  02 

(0041)  =  00 

(0042)  =  01 

This  set  consists  of  two  elements  in  the  wrong  order.  The  program  should  take  two 
passes.  The  first  pass  should  rearrange  the  elements,  producing: 

(0041)  =  01 

(0042)  =  00 
C  =  01 

The  second  pass  should  complete  the  operation  and  produce: 

C  =  00 

This  program  is  rather  long  for  single  stepping,  so  we'll  use  breakpoints  instead.  Each 
breakpoint  will  halt  the  computer  and  print  the  contents  of  all  the  registers.  The  break- 
points will  come: 

1)  After  LD  HL,41H  to  check  the  initialization. 

2)  After  CP  (HL)  to  check  the  comparison. 

3)  After  the  second  INC  HL  (i.e..  |ust  before  the  label  CNT)  to  check  the  interchange. 

4)  After  DEC  C  to  check  the  completion  of  a  pass  through  the  array.  The  contents  of 
the  registers  after  the  first  breakpoint  were: 

Register  Contents 

A 


02 
01 
00 
00 
41 


These  are  all  correct,  so  the  program  is  performing  the  initialization  correctly  m  this 
case. 
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The  results  at  the  second  breakpoint  were: 


Register 

Contents 

A 

00 

B 

01 

C 

00 

H 

00 

L 

42 

CARRY 

1 

These  results  are  also  correct.  The  results  at  the  third  breakpoint  were: 

Register  Contents 
A 


00 
01 
00 
01 
00 
42 


Checking  memorv  showed: 


(0041)  =  01 

(0042)  =  00 


The  results  at  the  fourth  breakpoint  were: 

Register 
A 


Contents 
00 
01 
00 
01 
00 
42 


Here,  Register  C  does  not  contain  the  correct  value  —  it  should  have  been  set  to  one  to 
indicate  that  an  interchange  had  occurred.  In  fact,  a  look  at  the  program  shows  that  no 
instruction  ever  changes  C  to  mark  the  interchange.  The  correction  is  to  place  the  in- 
struction LD  C.1  after  JR  NCCNT 

Now  the  procedure  is  to  load  Register  C  with  the  correct  value  and  continue.  The  sec- 
ond Iteration  of  the  second  breakpoint  gives: 


Register 

Contents 

A 

00 

B 

00 

C 

00 

H 

00 

L 

43 

CARRY 

1 

Clearly  the  program  has  proceeded  incorrectly  without  reinitializing  the  registers  (par- 
ticularly HL).  The  conditional  jump  that  depends  on  the  interchange  flag  should  transfer 
control  all  the  way  back  to  the  start  of  the  program,  not  to  the  label  PASS1. 
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The  final  version  of  the  program  is: 

SORT 


PASS1 


1  n 
LU 

r  n 

•n  PAR  IMTPRPMAMnP  Pi  Afi 

i  n 

LU 

A  MOMi 

M,  vHun/ 

■rni  iMT  --  i  PMHTM  np  array 

Lr 

0 

z 

■nnPC  ARRAV  UA\/P  9  OR  NylHRP  Pi  PNylPMTQ? 

JH 

■Nin   Nin  APTinM  NfPPPQQARV 
J^U,  INU  Mkj  1  IL/fNJ  iNcL-COOMn  I 

LU 

R  A 

Utu 

□ 
D 

LL/ 

Ml  A^  H 

■POINT  TO  ^TART  OF  ARRAY 

LU 

A  fWM 
rt,  inL? 

■  nPT  PI  PNylPMT  PROM  ARRAY 

INC 

HL 

CP 

(HI) 

■IS  IT  i  FSS  THAN  NEXT  ELEMENT? 

JR 

NT  TNT 

ND  KID  INTFRCHANGE  NECESSARY 

1  n 

■  Ypc  ccj  INTFRrHANRF  Fl  AG 

LD 

D,(HL) 

•INTFRCHANGF  ELEMENTS 

1  n 

LL-' 

(HI  )  A 

DEC 

HL 

LD 

(HL),D 

!NC 

HL 

DJNZ 

PASS1 

DEC 

C 

:WAS  INTERCHANGE  FLAG  SET? 

JR 

NZ.SORT 

:YES,  DO  ANOTHER  PASS 

HALT 

CNT 


Clearly  we  cannot  check  all  the  possible  input  values  for  this  program.  Two  other  simple 
sets  of  data  for  debugging  purposes  are: 

1)  Two  equal  elements 

(0040)  =  02 

(0041)  =  00 

(0042)  =  00 

2)  Two  elements  already  in  decreasing  order 

(0040)  =  02 

(0041)  =  01 

(0042)  =  00 
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INTRODUCTION  TO  TESTING   

Program  testing  is  closely  related  to  program  debugging.       USING  TEST 
Surely  some  of  the  test  cases  will  be  the  same  as  the  test       CASES  FROM 
data  used  for  debugging,  such  as:  DEBUGGING 

•  Trivial  cases  such  as  no  data  or  a  single  element 

•  Special  cases  that  the  program  singles  out  for  some  reason 

•  Simple  examples  that  exercise  particular  parts  of  the  program 

In  the  case  of  the  decimal  to  seven-segment  conversion  program,  these  cases 
cover  all  the  possible  situations.  The  test  data  consists  of: 

•  The  numbers  0  through  9 

•  The  boundary  case  10 

•  The  random  case  6B 

The  program  does  not  distinguish  any  other  cases.  Here  debugging  and  testing  are 
virtually  the  same. 

In  the  sorting  program,  the  problem  is  more  difficult.  The  number  of  elements  could 
range  from  0  to  255,  and  each  of  the  elements  could  lie  anywhere  in  that  range.  The 
number  of  possible  cases  is  therefore  enormous.  Furthermore,  the  program  is 
moderately  complex.  How  do  we  select  test  data  that  will  give  us  a  degree  of  confi- 
dence in  that  program?  Here  testing  requires  some  design  decisions.  The  testing 
problem  is  particularly  difficult  if  the  program  depends  on  sequences  of  real- time  data. 
How  do  we  select  the  data,  generate  it,  and  present  it  to  the  microcomputer  in  a 
realistic  manner? 

Most  of  the  tools  mentioned  earlier  for  debugging  are  helpful 
in  testing  also.  Logic  or  microprocessor  analyzers  can  help 
check  the  hardware;  simulators  can  help  check  the  software. 
Other  tools  can  also  be  of  assistance,  e.g., 

1)  I/O  simulations  that  can  simulate  a  variety  of  devices  from  a  single  input  and  a 
single  output  device. 

2)  In-circuit  emulators  that  allow  you  to  attach  the  prototype  to  a  development 
system  or  control  panel  and  test  il. 

3)  ROM  simulators  that  have  the  flexibility  of  a  RAM  but  the  timing  of  the  particular 
ROM  or  PROM  that  will  be  used  in  the  final  system. 

41  Real-time  operating  systems  that  can  provide  inputs  or  interrupts  at  specific 
times  !or  perhaps  randomly)  and  mark  the  occurrence  of  outputs.  Real-time  break- 
points and  traces  may  also  be  included. 

5)  Emulations  (often  on  micro  programmable  computers)  that  may  provide  real-time 
execution  speed  and  programmable  1/0.^ 

6)  Interfaces  that  allow  another  computer  to  control  the  I/O  system  and  test  the 
microcomputer  program. 

7)  Testing  programs  that  check  each  branch  in  a  program  for  logical  errors. 

8)  Test  generation  programs  that  can  generate  random  data  or  other  distributions. 

Formal  testing  theorems  exist,  but  they  are  usually  applicable  only  to  very  short  pro- 
grams. 

You  must  be  careful  that  the  test  equipment  does  not  invalidate  the  test  by 
modifying  the  environment.  Often,  test  equipment  may  buffer,  latch,  or  condition 
input  and  output  signals.  The  actual  system  may  not  do  this,  and  may  therefore 
behave  quite  differently. 


TESTING 
AIDS 
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Furthermore,  extra  software  in  the  test  environment  may  use  some  of  the  memo- 
ry space  or  part  of  the  interrupt  system,  it  may  also  provide  error  recovery  and 
other  features  that  w/ill  not  exist  in  the  final  system.  A  software  test  bed  must  be 
lust  as  realistic  as  a  hardware  test  bed.  since  software  failure  can  be  |ust  as  critical  as 
fiardware  failure. 

Emulations  and  simulations  are,  of  course,  never  precise.  They  are  usually  ade- 
quate for  checking  logic,  but  can  seldom  help  test  the  interface  or  the  timing.  On 
the  other  hand,  real-time  test  equipment  does  not  provide  much  of  an  overview  of 
the  program  logic  and  may  affect  the  interfacing  and  timing. 

SELECTING  TEST  DATA 

Very  few  real  programs  can  be  checked  for  all  cases.  The  designer  must  choose  a 
sample  set  that  in  some  sense  describes  the  entire  range  of  possibilities. 


STRUCTURED 
TESTING 


TESTING 
SPECIAL 
CASES 


Testing  should,  of  course,  be  part  of  the  total  development  pro- 
cedure. Top-down  design  and  structured  programming  provide  for 
testing  as  part  of  the  design.  This  is  called  structured  testing. ^ 
Each  module  within  a  structured  program  should  be  checked  separately.  Testing,  as 
well  as  design,  should  be  ^nodular,  structured,  and  top-down. 

But  that  leaves  the  question  of  selecting  test  data  for  a 
module.  The  designer  must  first  list  all  special  cases  that  a 
program  recognizes.  These  may  include: 

•  Trivial  cases 

•  Equality  cases 

•  Special  situations 

The  test  data  should  include  all  of  these. 

You  must  next  identify  each  class  of  data  that  statements 
within  the  program  may  distinguish.  These  may  include: 

•  Positive  or  negative  numbers 

•  Numbers  above  or  below  a  particular  threshold 

•  Data  that  does  or  does  not  include  a  particular  sequence  or  character 

•  Data  that  is  or  is  not  present  at  a  particular  time 

If  the  modules  are  short,  the  total  number  of  classes  should  still  be  small  even  though 
each  division  is  multiplicative:  i.e..  two  two-way  divisions  result  in  four  data  classes. 


FORMING 
CLASSES 
OF  DATA 


You  must  now  separate  the  classes  according  to  whether  the  SELECTING 
program  produces  a  different  result  for  each  entry  in  the  class        DATA  FROM 
(as  in  a  table)  or  produces  the  same  result  for  each  entry  (such  CLASSES 
as  a  warning  that  a  parameter  is  above  a  threshold).  In  the  dis- 
crete case,  one  may  include  each  element  if  the  total  number  is  small  or  sample  if  the 
number  is  large.  The  sample  should  include  all  boundary  cases  and  at  least  one  case 
selected  randomly.  Random  number  tables  are  available  in  books,  and  random  number 
generators  are  part  of  most  computer  facilities. 

You  must  be  careful  of  distinctions  that  may  not  be  obvious.  For  example,  an  8-bit 
microprocessor  will  regard  an  8-bit  unsigned  number  greater  than  127  as  nega- 
tive; the  programmer  must  consider  this  when  using  conditional  branches  that 
depend  on  the  Sign  flag.  You  must  also  watch  for  instructions  that  do  not  affect 
flags,  overflow  in  signed  arithmetic,  and  the  distinctions  between  address-length 
(16-bit)  quantities  and  data-length  (8-bit)  quantities. 
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Testing  Example  1 :  Sort  Program 


The  special  cases  here  are  obvious: 
•  No  elements  in  the  array 


TESTING 
A  SORT 
PROGRAM 


•  One  element,  magnitude  may  be  selected  randomly  ' 

The  other  special  case  to  be  considered  is  one  in  which  elements  are  equal. 

There  may  be  some  problem  here  with  signs  and  data  length.  Note  that  the  array  itself 
must  contain  fewer  than  256  elements.  The  use  of  the  instruction  LD  C.1  or  SET  1.C 
rather  than  DEC  C  to  clear  the  interchange  flag  means  that  there  will  be  no  difficulty  if 
the  number  of  elements  or  interchanges  exceeds  128. 

We  could  check  the  effects  of  sign  by  picking  half  the  regular  test  cases  with  numbers 
of  elements  between  1 28  and  255  and  half  between  2  and  1 27,  All  magnitudes  should 
be  chosen  randomly  so  as  to  avoid  unconscious  bias  as  much  as  possible. 

Testing  Example  2:  Self-Checking  Numbers  (see  Chapter  8) 

Here  we  will  presume  that  a  prior  validity  check  has  ensured  that        TESTING  AN 
the  number  has  the  right  length  and  consists  of  valid  digits.  Since  ARITHMETIC 
the  program  makes  no  other  distinctions,  test  data  should  be  PROGRAM 
selected  randomly.  Here  a  random  number  table  or  random  num- 
ber generator  will  prove  ideal;  the  range  of  the  random  numbers  is  0  to  9. 


1)  Try  to  eliminate  trivial  cases  as  early  as  possible  without  in- 
troducing unnecessary  distinctions. 

2)  Minimize  the  number  of  special  cases.  Each  special  case  means  additional  testing 
and  debugging  time. 

3)  Consider  performing  validity  or  error  checks  on  the  data  prior  to  processing. 

4)  Be  careful  of  inadvertent  and  unnecessary  distinctions,  particularly  in  handling 
signed  numbers  or  using  operations  that  refer  to  signed  numbers. 

5)  Check  boundary  cases  by  hand.  These  are  often  a  source  of  errors.  Be  sure  that  the 
problem  definition  specifies  what  is  to  happen  in  these  cases. 

6)  Make  the  program  as  general  as  reasonably  possible.  Each  distinction  and  separate 
routine  increases  the  required  testing. 

7)  Divide  the  program  and  design  the  modules  so  thai  the  testing  can  proceed  in 
steps  in  con|unction  with  the  other  stages  of  software  development.'' 


TESTING  PRECAUTIONS 

The  designer  can  simplify  the  testing  stage  by  designing  pro- 
grams sensibly.  You  should  use  the  following  rules: 


RULES  FOR 
TESTING 
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CONCLUSIONS 

Debugging  and  testing  are  the  stepchildren  of  the  software  development  process. 
Most  projects  leave  far  too  little  time  for  them  and  most  textbooks  neglect  them. 
But  designers  and  managers  often  find  that  these  stages  are  the  most  expensive 
and  time-consuming.  Progress  may  be  very  difficult  to  measure  or  produce. 
Debugging  and  testing  microprocessor  software  is  particularly  difficult  because 
the  powerful  hardware  and  software  tools  that  can  be  used  on  larger  computers 
are  seldom  available  for  microcomputers. 

The  designer  should  plan  debugging  and  testing  carefully.  We  recommend  the 
following  procedure: 

1)  Try  to  write  programs  that  can  easily  be  debugged  and  tested.  Modular  pro- 
gramming, structured  programming,  and  top-down  design  are  useful  techni- 
ques. 

2)  Prepare  a  debugging  and  testing  plan  as  part  of  the  program  design.  Decide 
early  what  data  you  must  generate  and  what  equipment  you  will  need. 

3)  Debug  and  test  each  module  as  part  of  the  top-down  design  process. 

4)  Debug  each  module's  logic  systematically.  Use  checklists,  breakpoints,  and 
the  single-step  mode.  If  the  program  logic  is  complex,  consider  using  the  soft- 
ware simulator, 

5)  Check  each  module's  timing  systematically  if  this  is  a  problem.  An 
oscilloscope  can  solve  many  problems  if  you  plan  the  test  properly.  If  the  tim- 
ing is  complex,  consider  using  a  logic  or  microprocessor  analyzer. 

6)  Be  sure  that  the  test  data  is  a  representative  sample.  Watch  for  any  classes  of 
data  that  the  program  may  distinguish.  Include  all  special  and  trivial  cases. 

7)  If  the  program  handles  each  element  differently  or  the  number  of  cases  is 
large,  select  the  test  data  randomly.^ 

8)  Record  all  test  results  as  part  of  the  documentation.  If  problems  occur,  you 
will  not  have  to  repeat  test  cases  that  have  already  been  checked. 
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Chapter  15 
DOCUMENTATION  AND  REDESIGN 


The  working  program  is  not  the  only  requirement  of  software  development.  Ade- 
quate documentation  is  also  an  important  part  of  a  software  product.  Not  only 
does  documentation  help  the  designer  in  the  testing  and  debugging  stages,  it  is 
also  essential  for  later  use  and  extension  of  the  program.  A  poorly  documented 
program  will  be  difficult  to  maintain,  use,  or  extend. 

Occasionally,  a  program  uses  too  much  memory  or  executes  too  slowly.  The 
designer  must  then  improve  it.  This  stage  is  called  redesign,  and  requires  that  you 
concentrate  on  the  parts  of  the  program  that  can  yield  the  most  improvement. 

SELF-DOCUMENTING  PROGRAMS 

Although  no  program  is  ever  completely  self-document- 
ing, some  of  the  rules  that  we  mentioned  earlier  can  help. 
These  include: 

•  Clear,  sinnple  structure  with  as  few  transfers  of  control 
ijumps)  as  possible 

•  Use  of  meaningful  names  and  labels 

•  Use  of  names  for  I/O  devices,  parameters,  numerical  factors,  etc. 

•  Emphasis  on  simplicity  rather  than  on  minor  savings  in  memorv  usage,  execution 
time,  or  typing 

For  example,  the  following  program  sends  a  string  of  characters  to  a  teletypewriter: 


LD 

A,(2000H) 

LD 

B,A 

LD 

HLIOOOH 

LD 

A,(HL) 

OUT 

(6),A 

CALL 

XXX 

INC 

HL 

DJNZ 

W 

HALT 

Even  without  comments  we  can  improve  the  program,  as  follows: 


MESSG 

EQU 

1000H 

COUNT 

EQU 

2000H 

TTYSIO 

EQU 

6 

LD 

A,!COUNTi 

LD 

B,A 

LD 

HL,MESSG 

OUTCH: 

LD 

A,(HL) 

OUT 

!TTYSIO),A 

CALL 

BITDLY 

INC 

HL 

DJNZ 

OUTCH 

HALT 

RULES  FOR 

SELF-DOCUMENTING 

PROGRAMS 
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Surely  this  program  is  easier  to  understand  than  the  earlier  version.  Even  without 
further  documentation,  you  could  probably  guess  at  the  function  of  the  program  and 
the  meanings  of  most  of  the  variables.  Other  documentation  techniques  cannot 
substitute  for  self-documentation. 


CHOOSING 
USEFUL 
NAMES 


Some  further  notes  on  choosing  names: 

1)  Use  the  obvious  name  when  it  is  available,  like  TTY  or  CRT 
for  output  devices,  START  or  RESET  for  addresses,  DELAY  or 
SORT  for  subroutines,  COUNT  or  LENGTH  for  data. 

2)  Avoid  acronyms  like  S16BA  for  SORT  16-BIT  ARRAY,  These  seldom  mean  any- 
thing to  anybody. 

3)  Use  full  words  or  close  to  full  words  when  possible,  like  DONE,  PRINT,  SEND,  etc. 

4)  Keep  the  names  as  distinct  as  possible. 

COMMENTS 

The  most  obvious  form  of  additional  documentation  is  the  comment.  However, 
few  programs  (even  those  used  as  examples  in  books),  have  effective  comments. 
You  should  consider  the  following  guidelines  for  good  comments. 


1)  Don't  repeat  the  meaning  of  the  instruction  code.  Rather.  COMIMENTING 

explain  the  purpose  of  the  instruction  in  the  program.  Com-  GUIDELINES 
ments  like 

DECS      ;B  =  B-1 
add  nothing  to  documentation.  Rather,  use 

DEC  8      iLINE  NUMBER  =  LINE  NUMBER-1 
Remember  that  you  know  what  the  operation  codes  mean  and  anyone  else  can 
look  them  up  in  the  manual.  The  important  point  is  to  explain  what  task  the 
program  is  performing. 

2)  Make  the  comments  as  clear  as  possible.  Do  not  use  abbreviations  or  acronyms 
unless  they  are  well-known  (like  ASCII,  PIO,  or  UART)  or  standard  (like  no  for  num- 
ber, ms  for  millisecond,  etc.).  Avoid  comments  like 

DEC  B  :LN=LN-1 
or 

DEC  B  ;DEC  LN  BY  1 

The  extra  typing  simply  is  not  all  that  expensive. 

3)  Comment  every  important  or  obscure  point.  Be  particularly  careful  to  mark 
operations  that  may  not  have  obvious  functions,  such  as 

AND  110111118     :TURN  TAPE  READER  BIT  OFF 

or 

ADD  HL,DE  ;INDEX  GRAY  CODE  TABLE 

Clearly,  I/O  operations  often  require  extensive  comments.  If  you're  not  exactly 
sure  of  what  an  instruction  does,  or  if  you  have  to  think  about  it,  add  a  clarifying 
comment.  The  comment  will  save  you  time  later  and  will  be  helpful  in  documenta- 
tion. 
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4)  Don't  comment  the  obvious,  A  comment  on  each  line  simply  makes  it  difficult  to 
find  the  important  points.  Standard  sequences  like 

INC  HL 
DJNZ  SEARCH 

need  not  be  marked  unless  you're  doing  something  special.  One  comment  will 
often  suffice  for  several  lines,  as  in 

RRCA  :SWAP  DIGITS 

RRCA 

RRCA 

RRCA 

LD  A.C  ;EXCHANGE  MOST  SIGNIFICANT.  LEAST 

LD  C.B  .    SIGNIFICANT  BYTES 

LD  B,A 

5)  Place  comments  on  the  lines  to  which  they  refer  or  at  the  start  of  a  se- 
quence. 

6)  Keep  your  comments  up-to-date.  If  you  change  the  program,  change  the  com- 
ments. 

7)  Use  standard  forms  and  terms  in  commenting.  Don  t  worry  about  repetitiveness. 
Varied  names  for  the  same  things  are  confusing,  even  if  the  variations  are  |ust 
COUNT  and  COUNTER,  START  and  BEGIN,  DISPLAY  and  LEDS.  or  PANEL  and 
SWITCHES. 

There's  no  real  gam  in  not  being  consistent.  The  variations  may  seem  obvious  to 
you  now,  but  may  not  be  clear  later:  others  will  get  confused  from  the  very  begin- 
ning. 

8)  Make  comments  mingled  with  instructions  brief.  Leave  a  complete  explanation 
to  header  comments  and  other  documentation.  Otherwise,  the  program  gets  lost 
in  the  comments  and  you  may  have  a  hard  time  even  finding  it. 

9)  Keep  improving  your  comments.  If  you  come  to  one  that  you  can  t  read  or  un- 
derstand, take  the  time  to  change  it.  If  you  find  that  the  listing  is  getting  crowded, 
add  some  blank  lines.  The  comments  won't  improve  themselves:  in  fact,  they  will 
lust  become  worse  as  you  leave  the  task  behind  and  forget  exactly  what  you  did. 

10)  Before  every  major  section,  subsection,  or  subroutine,  insert  a  number  of 
comments  describing  the  functions  of  the  code  that  follows.  Care  should  be 
taken  to  describe  all  inputs,  outputs,  and  side  effects,  as  well  as  the  algorithm 
employed. 

11)  It  IS  good  practice  when  modifying  working  programs  to  use  comments  to  in- 
dicate the  date,  author,  and  type  of  modification  made. 

Remember,  comments  are  important.  Good  ones  will  save  you  time  and  effort.  Put 
some  work  into  comments  and  try  to  make  them  as  effective  as  possible. 
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Commenting  Example  1 :  Multiple-Precision 
Addition 

The  basic  program  is: 


ADDWD: 


COMMENTING 
EXAMPLES 


LD 

A.!30H) 

LD 

B.A 

LD 

HL,41H 

LD 

DE,51H 

AND 

A 

LD 

A.(DE) 

ADC 

A,(HU 

LD 

!HL),A 

INC 

DE 

INC 

HL 

DJNZ 

ADDWD 

HALT 

First,  comment  the  important  points.  These  are  typically  initializations,  data  fetches, 
and  processing  operations.  Don't  bother  with  standard  sequences  like  updating  poin- 
ters and  counters.  Remember  that  names  are  clearer  than  numbers,  so  use  them  freely. 

The  new  version  of  the  program  is: 

MULTIPRECISION  ADDITION 


;THIS  PROGRAM  PERFORMS  MULTI-BYTE  ADDITION 

:  INPUTS:      LOCATION  30H  =  LENGTH  OF  NUMBERS  (IN  BYTES) 

LOCATIONS  41 H-50H  =  FIRST  ADDEND  IN  LSB— MSB  ORDER 
LOCATIONS  51 H-60H  =  SECOND  ADDEND 

:OUTPUTS;   LOCATIONS  41 H-51H  =  SUM 


LENGTH 

EQU 

30H 

NUMB1 

EQU 

41H 

NUMB2 

EQU 

51H 

LDA 

LENGTH 

:COUNT  =  LENGTH  OF  NUMBERS  (If 

LD 

B.A 

LD 

HLNUMBI 

:START  AT  LSB'S  OF  1ST  NUMBER 

LD 

DE.NUMB2 

;START  AT  LSB'S  OF  2ND  NUMBER 

AND 

A 

ADDWD: 

LD 

A,!DEj 

:GET  8  BITS  OF  2ND  NUMBER 

ADC 

A,(HL) 

:ADD  8  BITS  OF  1ST  NUMBER 

LD 

(HU.A 

:STORE  RESULT  IN  1ST  NUMBER 

INC 

DE 

INC 

HL 

DJNZ 

ADDWD 

HALT 

Second,  look  for  any  instructions  that  might  not  have  obvious 
functions  and  mark  them.  Here,  the  purpose  of  AND  A  is  to  clear 
the  Carry  the  first  time  through. 

Third,  ask  yourself  whether  the  comments  tell  you  what  you  would 
need  to  know  if  you  wanted  to  use  the  program,  e.g.: 

1)  Where  is  the  program  entered?  Are  there  alternative  entry  points? 

2)  What  parameters  are  necessary?  How  and  in  what  form  must  they  be  supplied? 


QUESTIONS 
FOR 

COMMENTING 
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3)  What  operations  does  the  program  perform? 

4)  From  where  does  it  get  the  data? 

5)  Where  does  it  store  the  results? 

6)  What  special  cases  does  it  consider? 

71    What  does  the  program  do  about  errors? 
8)    How  does  it  exit? 

Some  of  the  questions  mav  not  be  relevant  to  a  particular  program  and  some  of  the 
answers  may  be  obvious.  Make  sure  that  you  won't  have  to  sit  down  and  dissect  the 
program  to  figure  out  what  the  answers  are.  Remember  that  too  much  explanation  is 
lust  dead  wood  that  you  will  have  to  clear  out  of  the  way.  Is  there  anything  that  you 
would  add  to  or  subtract  from  this  listing?  If  so,  go  ahead  —  you  are  the  one  who  has  to 
feel  that  the  commenting  is  adequate  and  reasonable. 

,  MULTIPRECISION  ADDITION 


THIS  PROGRAM  PERFORMS  MULTI-BYTE  ADDITION 


INPUTS:    LOCATION  30H  =  LENGTH  OF  NUMBERS  ilN  BYTESl 

LOCATIONS  41H-50H  =  FIRST  ADDEND  IN  LSB— MSB  ORDER 
LOCATIONS  51H-60H  =  SECOND  ADDEND 

OUTPUTS; LOCATIONS  41H-51H  =SUM 


LENGTH 

ECU 

30H 

;LENGTH  OF  NUMBERS 

NUMB1 

EQU 

41H 

:LSB'S  OF  1ST  NUMBER  AND  RESULT 

NUMB2 

EQU 

51H 

:LSB'S  OF  2ND  NUMBER 

LDA 

LENGTH 

:COUNT  =  LENGTH  OF  NUMBERS  (IN  BYTES) 

LD 

B,A 

LD 

HLNUMBl 

;START  AT  LSB'S  OF  1ST  NUMBER 

LD 

DE.NUMB2 

:START  AT  LSB'S  OF  2ND  NUMBER 

AND 

A 

;CLEAR  CARRY  TO  START 

ADDWD: 

LD 

A,(DE) 

;GET  8  BITS  OF  2ND  NUMBER 

ADC 

A,(HL) 

;ADD  8  BITS  OF  1ST  NUMBER 

LD 

(HU.A 

;STORE  RESULT  IN  1ST  NUMBER 

INC 

DE 

INC 

HL 

DJNZ 

ADDWD 

HALT 

Commenting  Example  2:  Teletypewriter  Output 

The  basic  program  is: 


TBIT: 


LD 

ADD 

LD 

OUT 

RRA 

SCF 

CALL 

DJNZ 

HALT 


A,(60H) 
.A.A 
8.1 1 

(PIODRB).A 


BITDLY 
TBIT 
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Commenting  the  important  points  and  adding  names  gives: 
:TELETYPEWRITER  OUTPUT  PROGRAM 

:THIS  PROGRAM  PRINTS  THE  CONTENTS  OF  MEMORY  LOCATION  60H  TO  THE 
;  TELETYPEWRITER 

;    INPUTS:    LOCATION  60H  =  CHARACTER  CODE 
.    OUTPUTS:  NONE 


TTYPIO 

EQU 

PIODRB 

NBITS 

EQU 

11 

NUMBER  OF  BITS  PER  CHARACTER 

TDATA 

EQU 

60H 

ADDRESS  OF  CHARACTER  TO  BE 

TRANSMITTED 

LD 

A,  (TDATA) 

GET  DATA 

ADD 

A.A 

SHIFT  LEFT  AND  FORM  START  BIT 

LD 

B.NBITS 

COUNT  =  NUMBER  OF  BITS  PER  CHARACTER 

TBIT; 

OUT 

(TTYPIOIA 

SEND  BIT  TO  TTY 

RRA 

UPDATE  FOR  NEXT  BIT 

SCF 

FORM  STOP  BIT  lOGIC  ONE! 

CALL 

BITDLY 

DELAY  1  BIT  TIME 

DJNZ 

TBIT 

HALT 

Note  how  easily  we  could  change  this  program  so  that  it  would  transfer  a  whole  string 
of  data,  starting  at  the  address  in  locations  DPTR  and  DPTR  +  1  and  ending  with  an 
"03"  character  iASCII  ETX).  Furthermore,  let  us  make  the  terminal  a  30  character  per 
second  device  with  one  stop  bit  (we  will  have  to  change  subroutine  BITDLY).  Try  mak- 
ing the  changes  before  looking  at  the  listing, 

iSTRING  OUTPUT  PROGRAM 

:THIS  PROGRAM  OUTPUTS  A  STRING  TO  THE  TERMINAL  TRANSMISSION  CEASES 
:    WHEN  AN  ASCII  ETX  (30H)  IS  ENCOUNTERED 

:    INPUTS:    LOCATIONS  60H-61 H  CONTAIN  ADDRESS  OF 
:  STRING  TO  OUTPUT 

.    OUTPUTS:  NONE 


DPTR 

EQU 

60H 

LOCATION  OF  OUTPUT  BUFFER  START 

ADDRESS 

ENOCH 

EQU 

03 

ENDING  CHARACTER  =  ASCII  ETX 

NBITS 

EQU 

11 

NUMBER  OF  BITS  PER  CHARACTER 

TTYPIO 

EQU 

PIODRB 

LD 

HL.(DPTR) 

GET  STARTING  ADDRESS  OF  STRING 

TCHAR: 

LD 

A,(HL) 

GET  A  CHARACTER 

CP 

ENOCH 

IS  IT  ENDING  CHARACTER? 

JR 

Z,DONE 

YES,  DONE 

ADD 

A,A 

SHIFT  DATA  LEFT  AND  FORM  START  BIT 

LD 

B.NBITS 

COUNT  =  NUMBER  OF  BITS  PER  CHARACTER 

TBIT; 

OUT 

(TTYPIOj.A 

SEND  BIT  TO  TTY 

RRA 

UPDATE  FOR  NEXT  BIT 

SCF 

FORM  STOP  BIT  (LOGIC  ONE) 

CALL 

BITDLY 

DELAY  1  BIT  TIME 

DJNZ 

TBIT 

INC 

HL 

JR 

TCHAR 

DONE: 

HALT 
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Good  comments  can  make  it  easy  for  you  to  change  a  program  to  meet  new  require- 
ments. For  example,  try  changing  the  last  program  so  that  it: 

•  Starts  each  message  with  ASCII  STX  (02  hex)  followed  by  a  three-digit  identification 
code  stored  in  memory  locations  0030  through  0032 

•  Adds  no  start  or  stop  bits 

•  Waits  1  ms  between  bits 

•  Transmits  40  characters,  starting  with  the  one  located  at  the  address  in  DPTR  and 
DPTR-l-1 

•  Ends  each  message  with  two  consecutiye  ASCII  ETXs  (03  hex) 

FLOWCHARTS  AS  DOCUMENTATION 

We  have  already  described  the  use  of  flowcharts  as  a  design  tool 
in  Chapter  13.  Flowcharts  are  also  useful  in  documentation,  partic- 
ularly if: 

•  They  are  not  so  detailed  as  to  be  unreadable 

•  Their  decision  points  are  clearly  explained  and  marked 

•  They  include  all  branches 
■  They  correspond  to  the  actual  program  listings 

Flowcharts  are  helpful  if  they  give  you  an  overall  picture  of  the  program.  They  are  not 
helpful  if  they  are  Just  as  difficult  to  read  as  an  ordinary  listing. 

STRUCTURED  PROGRAMS  AS  DOCUMENTATION 

A  structured  program  can  serve  as  documentation  for  an  assembly  language  program 

if: 

•  You  describe  the  purpose  of  each  section  in  the  comments 

•  You  make  it  clear  which  statements  are  included  in  each  conditional  or  loop  structure 
by  using  indentation  and  ending  markers 

•  You  make  the  total  structure  as  simple  as  possible 

•  You  use  a  consistent,  well-defined  language 

The  structured  program  can  help  you  to  check  the  logic  or  improve  it.  Furthermore, 
since  the  structured  program  is  machine-independent,  it  can  also  aid  you  in  implement- 
ing the  same  task  on  another  computer. 

MEMORY  MAPS 

A  memory  map  is  simply  a  list  of  all  the  memory  assignments  in  a  program.  The  map 
allows  you  to  determine  the  amount  of  memory  needed,  the  locations  of  data  or 
subroutines,  and  the  parts  of  memory  not  allocated.  The  map  is  a  handy  reference  for 
finding  storage  locations  and  entry  points  and  for  dividing  memory  between  different 
routines  or  programmers.  The  map  will  also  give  you  easy  access  to  data  and 
subroutines  if  you  need  them  in  later  extensions  or  in  maintenance.  Sometimes  a 
graphical  map  is  more  helpful  than  a  listing. 


HINTS  FOR 
USING 

FLOWCHARTS 
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A  typical  map  would  be: 


TYPICAL 

MEMORY 

MAP 


Program  Memory 

Address 

Routine 

Purpose 

0000-0002 

RESET 

TRANSFEFIS  CONTROL  TO  MAIN  PROGRAM  IN  LOCATION 

40  HEX 

0038-003A 

INTRPT 

TRANSFERS  CONTROL  TO  INTERRUPT  SERVICE 

IN  LOCATION  300  HEX 

0040-0265 

MAIN 

MAIN  PROGRAM 

0270-027F 

DELAY 

DELAY  PROGRAM 

0280-0290 

DSPLY 

DISPLAY  CONTROL  PROGRAM 

0300-0340 

KEVIN 

INTERRUPT  CONTROL  PROGRAM  FOR  KEYBOARD 

Data  Memory 

1000 

NKEYS 

NUMBER  OF  KEYS 

1001-1002 

KPTR 

KEYBOARD  BUFFER  POINTER 

1003-1041 

KBFR 

KEYBOARD  BUFFER 

1042-1051 

DBFR 

DISPLAY  BUFFER 

1052-105F 

TEMP 

TEMPORARY  STORAGE 

10E0-10FF 

STACK 

RAM  STACK 

RULES  FOR 
DEFINITION 
LISTS 


The  map  may  also  list  additional  entry  points  and  include  a  specific  description  of  the 
unused  parts  of  memory. 

PARAMETER  AND  DEFINITION  LISTS 

Parameter  and  definition  lists  at  tlie  start  of  the  program  and  each  subroutine 
make  understanding  and  changing  the  program  far  simpler.  The  following  rules  can 
help: 

1)  Separate  RAM  locations,  I/O  units,  parameters,  defini- 
tions, and  memory  system  constants. 

2)  Arrange  lists  alphabetically  when  possible,  with  a  descrip- 
tion of  each  entry. 

3)  Give  each  parameter  that  might  change  a  name  and  include  it  in  the  lists.  Such 
parameters  may  include  timing  constants,  inputs  or  codes  corresponding  to  partic- 
ular l<eys  or  functions,  control  or  masking  patterns,  starting  or  ending  characters, 
thresholds,  etc. 

4)  Make  the  memory  system  constants  into  a  separate  list.  These  constants  will 
include  Reset  and  interrupt  service  addresses,  the  starting  address  of  the  program, 
RAM  areas.  Stack  areas,  etc. 

5)  Give  each  port  used  by  an  I/O  device  a  name,  even  though  devices  may  share 
ports  in  the  current  system.  The  separation  will  make  expansion  or  reconfiguration 
much  simpler. 
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A  typical  list  of  definitions  will  be: 

:MEMORY  SYSTEM  CONSTANTS 


TYPICAL 

DEFINITION 

LIST 


RESET 

EQU 

0 

RESET  ADDRESS 

INTRP 

EQU 

38H 

INTERRUPT  ENTRY 

START 

EQU 

40H 

START  OF  MAIN  PROGRAM 

KEVIN 

EQU 

300H 

KEYBOARD  INTERRUPT  PROGRAM 

RAMST 

EQU 

1000H 

START  OF  DATA  STORAGE 

STKPTR 

EQU 

1 100H 

.  I/O  UNITS 

DSPLY 

EQU 

OEOH 

OUTPUT  PIO  FOR  DISPLAYS 

KBDIN 

EQU 

0E1H 

INPUT  PIO  FOR  KEYBOARD 

KBDOUT 

EQU 

OEOH 

OUTPUT  PIO  FOR  KEYBOARD 

TTYPIO 

EQU 

OFOH 

TTY  DATA  PORT 

:RAM  LOCATIONS 

ORG 

RAMST 

NKEYS 

DEFS 

1 

NUMBER  OF  KEYS 

KBDPTR 

DEFS 

2 

KEYBOARD  BUFFER  POINTER 

KBDBFR 

DEFS 

40H 

KEYBOARD  INPUT  BUFFER 

DSPBFR 

DEFS 

10H 

DISPLAY  DATA  BUFFER 

TEMP 

DEFS 

14H 

TEMPORARY  STORAGE 

:PARAMETERS 

BOUNCE 

EQU 

2 

DEBOUNCING  TIME  IN  MS 

GOKEY 

EQU 

10 

IDENTIFICATION  OF  'GO'  KEY 

MSCNT 

EQU 

133 

COUNT  FOR  1  MS  DELAY 

OPEN 

EQU 

OFH 

PATTERN  FOR  OPEN  KEYS 

TPULS 

EQU 

1 

PULSE  LENGTH  FOR  DISPLAYS  IN 

iDEFINITIONS 

ALL1 

EQU 

OFFH 

ALL  ONES  PATTERN 

STCON 

EQU 

80H 

START  CONVERSION  PULSE 

Of  course,  the  RAM  entries  will  usually  not  be  in  alphabetical  order,  since  the  designer 
must  order  these  so  as  to  minimize  the  number  of  address  changes  required  in  the  pro- 


gram. 
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LIBRARY  ROUTINES 

Standard  documentation  of  subroutines  will  allow  you  to  build  up  a  library  of 
useful  programs.  The  idea  is  to  make  these  programs  easily  accessible.  A  standard  for- 
mat will  allow  you  or  anyone  else  to  see  at  a  glance  what  the  program  does.  The  best 
procedure  is  to  make  up  a  standard  form  and  use  it  consistently.  Save  these  programs 
in  a  well-organized  manner  (for  example,  according  to  processor,  language,  and  type  of 
program),  and  you  will  soon  have  a  useful  set.  But  remember  that  without  organiza- 
tion and  proper  documentation,  using  the  library  may  be  more  difficult  than  rewrit- 
ing the  program  from  scratch.  Debugging  a  system  requires  a  precise  understanding 
of  all  the  effects  of  each  subroutine. 


STANDARD 
PROGRAM 
LIBRARY 
FORMS 


Among  the  information  that  you  will  need  in  the  standard  form  is: 

•  Purpose  of  the  program 

•  Processor  used 

•  Language  used 

•  Parameters  required  and  how  they  are  passed  to  the  subroutine 

•  Results  produced  and  how  they  are  passed  to  the  mam  program 

•  Number  of  bytes  of  memory  used 

■  Number  of  clock  cycles  required.  This  number  may  be  an  average  or  a  typical  figure, 
or  it  may  vary  widely.  Actual  execution  time  will,  of  course,  depend  on  the  processor 
clock  rate 

•  Registers  affected 

•  Flags  affected 

•  A  typical  example 

•  Error  handling 

•  Special  cases 

■  Documented  program  listing 

If  the  program  is  complex,  the  standard  library  form  should  also  include  a  general 
flowchart  or  a  structured  program.  As  we  have  mentioned  before,  a  library  program  is 
most  likely  to  be  useful  if  it  performs  a  single  distinct  function  in  a  reasonably  general 
manner. 

LIBRARY  EXAMPLES 

Library  Example  1 :  Sum  of  Data 

Purpose:  The  program  SUMS  computes  the  sum  of  a  set  of  8-bit  unsigned  binary  num- 
bers. 

Language:  Z80  assembler. 

Initial  Conditions:  Starting  address  of  set  of  numbers  in  Register  Pair  HL,  length  of  set 
in  Accumulator. 

Final  Conditions:  Sum  in  Accumulator. 

Requirements: 

Memory    -    7  bytes. 

Time        -    13-1-  26N  clock  cycles,  where  N  is  the 

length  of  the  set  of  numbers. 
Registers  -   A,  B,  H,  L. 
All  flags  affected. 
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Typical  Case:  (all  data  in  hexadecimal) 
Start: 


HL 

=  0050 

A 

=  03 

(0050) 

=  27 

(0051) 

=  3E 

(0052) 

=  26 

End: 

A 

=  8B 

COUNT  =  LENGTH  OF  DATA  BLOCK 
SUM  =  ZERO 

SUM  =  SUM  +  DATA  ENTRY 


Error  Handling:  Program  ignores  all  carries.  Carry  bit  reflects  only  the  last  operation. 
Initial  contents  of  Accumulator  must  be  1  or  more. 

Listing: 

SUM  OF  8-BIT  DATA 

SUMS:     LD  B.A 

SUB  A 

ADDS:      ADD  A,(HU 

INC  HL 

DJNZ  ADDS 

RET 

Library  Example  2:  Decimal-to-Seven-Segment  Conversion 

Purpose:  The  program  SEVEN  converts  a  decimal  number  to  a  seven-segment  display 
code. 

Language:  Z80  assembler. 

Initial  Conditions:  Data  in  Accumulator. 

Final  Conditions:  Seven-segment  code  in  Accumulator. 

Requirements: 

Memory    -  26  bytes,  including  the  seven-segment  table  (10  en- 
tries). 

Time       -  74  clock  cycles  if  the  data  is  valid.  40  if  it  is  not. 
Registers  -  A.  B,  D.  E,  H.  L. 
-All  flags  affected. 

Input  data  in  Accumulator  is  destroyed. 

Typical  Case:  (data  m  hexadecimal) 

Start: 

A  =  05 

End: 

A  =  66 

Error  Handling:  Program  returns  zero  in  the  Accumulator  if  data  is  not  a  decimal  digit. 
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Listing: 


:DECIMAL  TO  SEVEN-SEGMENT  CONVERSION 


SEVEN: 


DONE: 
SSEG: 


LD 

B.O 

(If  J  FRROR  rODF  TO  Rl  ANK  DISPl  AY 

CP 

10 

I"?  DATA  A  DFriMAI  DIRIT' 

JR 

hir  nnNF 

Mf)  KFFP  FRROR  CODF 

1  n 

i  A 

YF"^  MAKF  DATA  INTO  A  Ifi-RIT  INDFy 

\  n 

i-U 

n.u 

LD 

L>  U. .     O  L. 

GFT  BA'?F  ADDRFSS  OF  7-SFRMFNT  TARI  F 

ADD 

HL.DE 

FIND  ELEMENT  BY  INDEXING 

LD 

B,(HL) 

GET  7-SEGMENT  CODE  FROM  TABLE 

LD 

A,B 

SAVE  7-SEGMENT  CODE  OR  ERROR  CODE 

RET 

DEFB 

3FH 

DEFB 

06H 

DEFB 

5BH 

DEFB 

4FH 

DEFB 

66H 

DEFB 

6DH 

DEFB 

7DH 

DEFB 

07H 

DEFB 

7FH 

DEFB 

6FH 

Library  Example  3:  Decimal  Sum 

Purpose;  The  program  DECSUM  adds  two  multi-word  decimal  numbers. 
Language:  Z80  assembler. 

Initial  Conditions:  Address  of  LSBs  of  one  number  in  Register  Pair  HL,  address  of  LSBs 
of  other  number  in  Register  Pair  DE.  length  of  numbers  (in  bytes)  in 
A.  Numbers  arranged  starting  with  LSBs  at  lowest  address. 

Final  Conditions:  Sum  replaces  number  with  starting  address  in  Register  Pair  HL. 

Requirements: 

Memory   -    1 1  bytes. 

Time       -    13  +  50N  clock  cycles,  where  N  is  the  number  of 

bytes  involved. 
Registers  -   A,  B.  D.  E,  H,  L. 

All  flags  affected.  Carry  shows  If  sum  produced  a  carry. 
Typical  Case:  (data  in  hexadecimal) 
Start: 

0060 
0050 
2 

34 
55 
88 
15 


HL 
DE 
A 

(0060) 
(0061) 
(0050) 
(0051) 
End: 
(0060) 
(0061) 
CARRY 


22 
71 
0 
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Error  Handling:  Program  does  not  check  the  validity  of  decimal  inputs.  Accumulator 
must  be  1  or  greater. 


Listing: 

DECSUM:      LD  B.A 

AND  A 

DECADD:      LD  A,(DE) 


COUNT  =  LENGTH  OF  NUMBERS  (IN  BYTES) 
CLEAR  CARRY  TO  START 
GET  2  DECIMAL  DIGITS  FROM  STRING  2 
ADD  PAIR  OF  DIGITS  FROM  STRING  1 


ADC  A,(HL) 
DAA 

LD  (HU.A 

INC  DE 

INC  HL 

DJNZ  DECADD 
RET 


MAKE  ADDITION  DECIMAL 
STORE  RESULT  IN  STRING  1 


TOTAL  DOCUMENTATION 


Complete  documentation  of  microprocessor  software  will  in-  DOCUIVAENTATION 
elude  all  or  most  of  the  elements  that  we  have  mentioned.  So,  PACKAGE 
the  total  documentation  package  may  involve:  t_— — 

•  General  flowcharts 

•  A  written  description  of  the  program 

•  A  list  of  all  parameters  and  definitions 

•  A  memory  map 

•  A  documented  listing  of  the  program 

•  A  description  of  the  test  plan  and  test  results 
The  documentation  may  also  include; 

•  Programmers'  flowcharts 

•  Data  flowcharts 

•  Structured  programs 

The  documentation  procedures  outlined  above  are  the  minimal  acceptable  set  of 
documents  for  non-production  software.  Production  software  demands  even 
greater  documentation  efforts.  The  following  documents  should  also  be  produced: 

•  Program  Logic  Manual 

•  User  Guide 

•  Maintenance  Manual 

The  program  logic  manual  expands  on  the  written  explanation  produced  with  the 
software.  It  should  be  written  for  a  technically  competent  individual  who  may  not 
possess  the  detailed  knowledge  assumed  in  the  written  explanation  in  the  software. 
The  program  logic  manual  should  explain  what  the  design  goals  of  the  system  were, 
what  algorithms  were  chosen  to  implement  these  goals,  and  what  tradeoffs  had  to  be 
made  in  achieving  them. 

It  should  then  explain  in  great  detail  what  data  structures  were  employed  and  how  they 
are  manipulated.  It  should  provide  a  step-by-step  guide  to  the  inner  workings  of  the 
code.  Finally,  it  should  contain  any  special  tables  or  graphs  that  help  explain  any  of  the 
concepts  embodied  in  the  code.  Code  conversion  charts,  state  diagrams,  translation 
matrices,  and  flowcharts  should  be  included. 

The  user  guide  is  probably  the  most  important  and  most  overlooked  piece  of  docu- 
mentation. No  matter  how  well  a  system  is  designed,  it  is  useless  if  no  one  can 
use  it  affectively.  The  user  guide  should  provide  all  users,  sophisticated  and  un- 
sophisticated, with  an  introduction  to  the  system.  It  should  then  provide  detailed  ex- 
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planations  of  system  features  and  their  use.  Use  plenty  of  exannples  because  a  good  ex- 
ample can  crystallize  the  information  contained  in  many  pages  of  text.  Step-by-step 
directions  should  be  given.  Test  the  user  guide,  i.e..  try  out  the  step-by-step  usage  pro- 
cedures as  you  haye  documented  them.  Programmers  with  detailed  knowledge  of  a 
system  s  design  often  take  shortcuts  that  are  not  at  all  apparent  to  the  general  reader. 
An  entire  book  could  be  written  about  the  writing  of  user  guides,  and  further  discussion 
is  beyond  the  scope  of  this  book.  However,  remember  that  you  can  never  spend  too 
much  effort  in  preparing  a  user  guide,  because  it  will  be  the  most  used  of  all  system 
documents. 

The  maintenance  manual  is  designed  for  the  programmer  who  has  to  modify  the 
system.  It  should  outline  step-by-step  procedures  for  those  reconfigurations  designed 
into  the  system.  In  addition,  it  should  outline  any  provisions  placed  into  code  for  future 
expansion. 

Documentation  should  not  be  taken  lightly  or  postponed  until  the  end  of  the  soft- 
ware development.  Proper  documentation,  combined  with  proper  programming 
practices,  is  not  only  an  important  part  of  the  final  product  but  can  also  make 
development  simpler,  faster,  and  more  productive.  The  designer  should  make  con- 
sistent and  thorough  documentation  part  of  every  stage  of  software  development. 

REDESIGN 

Sometimes  the  designer  may  have  to  squeeze  the  last  microsecond  of  speed  or 
the  last  byte  of  extra  memory  out  of  a  program.  As  larger  single-chip  memories  have 
become  available,  the  memory  problem  has  become  less  serious.  The  time  problem,  of 
course,  is  serious  only  if  the  application  is  time-critical:  in  many  applications  the 
microprocessor  spends  most  of  its  time  waiting  for  external  devices,  and  program  speed 
IS  not  a  maior  factor. 

Squeezing  the  last  bit  of  performance  out  of  a  program  is 
seldom  as  important  as  some  writers  would  have  you  believe. 
In  the  first  place,  the  practice  is  expensive  for  the  following 
reasons: 

1)  It  requires  extra  programmer  time,  which  is  often  the  single  largest  cost  in  software 
development. 

2)  It  sacrifices  structure  and  simplicity  with  a  resulting  increase  in  debugging  and 
testing  time. 

3)  The  programs  require  extra  documentation. 

4)  The  resulting  programs  will  be  difficult  to  extend,  maintain,  or  re-use. 

in  the  second  place,  the  lower  per-unit  cost  and  higher  performance  may  not  really 
be  important.  Will  the  lower  cost  and  higher  performance  really  sell  more  units?  Or 
would  you  do  better  with  more  user-oriented  features?  The  only  applications  that 
would  seem  to  justify  the  extra  effort  and  time  are  very  high-volume,  low-cost 
and  low-performance  applications  where  the  cost  of  an  extra  memory  chip  will  far 
outweigh  the  cost  of  the  extra  software  development.  For  other  applications,  you 
will  find  that  you  are  playing  an  expensive  game  for  no  reason. 

However,  if  you  must  redesign  a  program,  the  following      I  MAJOR  OR 
hints  will  help.  First,  determine  how  much  more  perfor-      I  MINOR 
mance  or  how  much  lass  memory  usage  is  necessary.  If     i  REORGANIZATION 
the  required  improvement  is  25%  or  less,  you  may  be  ' 
able  to  achieve  it  by  reorganizing  the  program.  If  it  is  more  than  25%,  you  have 
made  a  basic  design  error;  you  will  need  to  consider  drastic  changes  in  hardware 
or  software.  We  will  deal  first  with  reorganization  and  later  with  drastic  changes.  You 
should  also  look  at  Chapter  5  of  Z80  Programming  for  Logic  Design  for  some  examples. 
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Note  particularly  that  saving  memory  can  be  critical  if  it  allows  a  program  to  fit  into  the 
limited  amount  of  ROM  and  RAM  available  in  a  simple  one-chip  or  two-chip  microcom- 
puter. The  hardware  cost  for  small  systems  can  thus  be  substantially  reduced,  if  their 
requirements  can  be  limited  to  the  memory  size  and  I/O  limitations  of  that  particular 
one-chip  or  two-chip  system. 

REORGANIZING  TO  USE  LESS  MEMORY 


The  following  procedures  will  reduce  memory  usage  for  Z80  SAVING 
assembly  language  programs:  MEMORY 

1!    Replace  repetitious  in-line  code  with  subroutines.  Be 

sure,  however,  that  the  CALL  and  RETURN  instructions  do  not  offset  most  of  the 
gain.  Note  that  this  replacement  usually  results  in  slower  programs  because  of  the 
time  spent  in  transferring  control  back  and  forth. 

2)  Use  register  operations  when  possible.  But  remember  the  cost  of  the  extra  in- 
itialization. 

3)  Use  the  Stack  when  possible.  The  Stack  Pointer  is  automatically  updated  after 
each  use  so  that  no  explicit  updating  instructions  are  necessary. 

4)  Eliminate  Jump  instructions.  Try  to  reorganize  the  program  or  use  indirect  jumps 
(JP  !HL)  or  JP  (IX  or  lY)).  RST.  or  RETURN  instructions. 

5)  Take  advantage  of  addresses  that  you  can  manipulate  as  8-bit  quantities. 

These  include  page  zero  and  addresses  that  are  multiples  of  100  hexadecimal.  For 
example,  you  might  try  to  place  all  ROM  tables  in  one  lOOig-byte  section  of 
memory,  and  all  RAM  vanables  into  another  lOOig-byte  section. 

6)  Organize  data  and  tables  so  that  you  can  address  them  without  worrying 
about  address  calculation  carries  or  without  any  actual  indexing.  This  will 
again  allow  you  to  manipulate  16-bit  addresses  as  8-bit  quantities.  See  pages  5-1 
to  5-6  of  Z80  Programming  for  Logic  Design  for  an  example. 

7)  Use  the  16-bit  instructions  to  replace  two  separate  8-bit  operations.  This 
may  be  particularly  useful  in  initialization  or  storing  results. 

8!    Use  leftover  results  from  previous  sections  of  the  program. 

9)  Take  advantage  of  such  instructions  as  INC  !HU.  DCR  (HL).  LD  (HL),  RL  (HL).  and 
RR  !HL).  which  operate  directly  on  memory  locations  without  using  registers. 

10)  Use  INC  or  DEC  to  set  or  reset  flag  bits. 

1 1 )  Use  relative  jumps  rather  than  jumps  with  direct  addressing. 

1 2)  Take  advantage  of  the  Block  Move,  Block  Search,  and  Block  I/O  instructions 

whenever  you  are  handling  blocks  of  data. 

13)  Watch  for  special  short  forms  of  instructions  such  as  the  Accumulator  shifts 
(RLCA,  RLA.  RRCA.  and  RRA)  and  DJNZ. 

14)  Use  algorithms  rather  than  tables  to  calculate  arithmetic  or  logical  expressions 
and  to  perform  code  conversions.  Note  that  this  replacement  may  result  in  slower 
programs. 

1 5)  Reduce  the  size  of  mathematical  tables  by  interpolating  between  entries.  Here 
again,  we  are  saving  memory  at  the  cost  of  execution  time. 

16)  Take  advantage  of  the  alternate  register  set  to  cut  down  on  the  use  of 
storage.  This  can  save  time  as  well.   

Although  some  of  the  methods  that  reduce  memory  usage  also 
save  time,  you  can  generally  save  an  appreciable  amount  of 
time  only  by  concentrating  on  frequently  executed  loops.  Even 


SAVING 

EXECUTION 

TIME 
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completely  eliminating  an  instruction  that  is  executed  only  once  can  save  at  most  a  few 
microseconds.  But  a  sayings  in  a  loop  that  is  executed  frequently  will  be  multiplied 
many  times  over. 

So,  if  you  must  reduce  execution  time,  proceed  as  follows: 

1 1  Determine  how  frequently  each  program  loop  is  executed.  You  can  do  this  by 
hand  or  by  using  the  software  simulator  or  another  testing  method. 

2)  Examine  the  loops  in  the  order  determined  by  their  frequency  of  execution, 

starting  with  the  most  frequent.  Continue  through  the  list  until  you  achieve  the  re- 
quired reduction. 

3)  First,  see  if  there  are  any  operations  that  can  be  moved  outside  the  loop,  i.e.. 
repetitive  calculations,  data  that  can  be  placed  into  a  register  or  the  Stack,  ad- 
dresses that  can  be  placed  into  register  pairs  or  index  registers,  special  cases  or 
errors  that  can  be  handled  elsewhere,  etc.  Note  that  this  will  require  extra  in- 
itialization and  memory  but  will  save  time. 

4)  Try  to  eliminate  Jump  statements.  These  are  very  time-consuming.  Or.  use 
jumps  with  direct  addressing  that  require  more  memory  but  less  time  than  jumps 
with  relative  addressing. 

5)  Replace  subroutines  with  in-line  code.  This  will  save  at  least  a  CALL  and  a 
RETURN  instruction. 

6)  Use  the  Stack  for  temporary  data  storage. 

7)  Use  any  of  the  hints  mentioned  in  saving  memory  that  also  decrease  execu- 
tion time.  These  include  the  use  of  block  handling  instructions,  8-bit  addresses, 
16-bit  instructions,  RST.  special  short  forms  of  instructions,  etc. 

8)  Do  not  even  look  at  instructions  that  are  executed  only  once.  Any  changes 
that  you  make  in  such  instructions  only  invite  errors  for  no  appreciable  gam. 

9)  Avoid  indexed  and  relative  addressing  whenever  possible  because  they  take 
extra  time. 

1 0)    Use  tables  rather  than  algorithms;  make  the  tables  handle  as  much  of  the  tasks 
as  possible  even  if  many  entries  must  be  repeated. 

MAJOR  REORGANIZATIONS 

If  you  need  more  than  a  2S%  increase  in  speed  or  decrease  in  memory  usage,  do 
not  try  reorganizing  the  code.  Your  chances  of  getting  that  much  of  an  improve- 
ment are  small  unless  you  call  in  an  outside  expert.  You  are  generally  better  off 
making  a  major  change. 

The  most  obvious  change  is  a  better  algorithm.  Particularly  if  BETTER 

you  are  doing  sorts,  searches,  or  mathematical  calculations,  you  ALGORITHMS 

may  be  able  to  find  a  faster  or  shorter  method  in  the  literature.  ' 
Libraries  of  algorithms  are  available  in  some  journals  and  from  professional  groups.  See, 
for  example.  References  1  through  10  at  the  end  of  this  chapter. 

More  hardware  can  replace  some  of  the  software.  Counters,  shift  registers, 
arithmetic  units,  hardware  multipliers,  and  other  fast  add-ons  can  save  both  time  and 
memory.  Calculators,  UARTs,  keyboards,  encoders,  and  other  slower  add-ons  may  save 
memory  even  though  they  operate  slowly.  Compatible  parallel  and  serial  interfaces,  and 
other  devices  specially  designed  for  use  with  the  Z80  may  save  time  by  taking  some  of 
the  burden  off  the  CPU. 
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Other  changes  may  help  as  well: 

1)  A  CPU  with  a  longer  word  will  be  faster  if  the  data  is  long 
enough.  Such  a  CPU  will  use  less  total  memory-  16-bit  pro- 
cessors, for  example,  use  memory  more  efficientiv  than  8-bit 
processors,  since  more  of  their  instructions  are  one  word  long. 

2)  Versions  of  the  CPU  may  exist  that  operate  at  higher  clock  rates.  But  remem- 
ber that  you  will  need  faster  memory  and  I/O  ports,  and  you  will  have  to  adjust  any 
delay  loops. 

3)  Two  CPUs  may  be  able  to  do  the  job  in  parallel  or  separately  if  you  can  divide  the 
job  and  solve  the  communications  problem. 

4)  A  specially  microprogrammed  processor  may  be  able  to  execute  the  same  pro- 
gram much  faster.  The  cost,  however,  will  be  much  higher  even  if  you  use  an  off- 
the-shelf  emulation. 

5)  You  can  make  tradeoffs  between  time  and  memory.  Lookup  tables  and  function 
ROMs  will  be  faster  than  algorithms,  but  will  occupy  more  memory.  

This  kind  of  problem,  in  which  a  large  improvement  is  neces-  DECIDING 
sary,  usually  results  from  lack  of  adequate  planning  in  the     ON  A  MAJOR 
definition  and  design  stages.  In  the  problem  definition  stage  CHANGE 
you  should  determine  which  processor  and  methods  will  be 
adequate  to  handle  the  problem,  if  you  misjudge,  the  cost  later  will  be  high.  A 
cheap  solution  may  result  in  an  unwarranted  expenditure  of  expensive  develop- 
ment time.  Do  not  try  to  just  get  by;  the  best  solution  is  usually  to  do  the  proper 
design  and  chalk  a  failure  up  to  experience.  If  you  have  followed  such  methods  as 
flowcharting,  modular  programming,  structured  programming,  top-down  design, 
and  proper  documentation,  you  will  be  able  to  salvage  a  lot  of  your  effort  even  if 
you  have  to  make  a  major  change. 


OTHER 

MAJOR 

CHANGES 
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Chapter  16 
SAMPLE  PROJECTS 


PROJECT  #1 :  A  Digital  Stopwatch   

Purpose:  This  project  Is  a  digital  stopwatch.  The  operator  enters  STOPWATCH 
two  digits  (minutes  and  tenths  of  minutes)  from  a  INPUT 
calculator-like  keyboard  and  then  presses  the  GO  key.  PROCEDURE 
The  system  counts  down  the  remaining  time  on  two 
seven-segment  LED  displays  (see  Chapter  11  for  a  description  of  unencoded 
keyboards  and  LED  displays). 

Hardware:  The  project  uses  one  input  port  and  one  output  port  (one  Z80  Parallel 
Input/Output  Device  or  PIO),  two  seven-segment  displays,  a  12-key  keyboard,  a  7404 
inverter,  and  either  a  7400  NAND  gate  or  a  7408  AND  gate,  depending  on  the  polarity 
of  the  seven-segment  displays.  The  displays  may  require  drivers,  inverters,  and  resis- 
tors, depending  on  their  polarity  and  configuration. 

The  hardware  is  organized  as  shown  in  Figure  16-1 .  Output  lines  0.  1,  and  2  are  used  to 
scan  the  keyboard.  Input  lines  0,  1.2,  and  3  are  used  to  determine  whether  any  keys 
have  been  pressed.  Output  lines  0,  1 ,  2,  and  3  are  used  to  send  BCD  digits  to  the  seven- 
segment  decoder/drivers.  Output  line  4  is  used  to  activate  the  LED  displays  (if  line  4  is 
'1',  the  displays  are  lit).  Output  line  5  is  used  to  select  the  left  or  right  display;  output 
line  5  is  'T  if  the  left  display  is  being  used,  '0'  if  the  right  display  is  being  used.  Thus, 
the  common  line  on  the  left  display  should  be  active  if  Iine4  is  '1'  and  line  5  is  '1',  while 
the  common  line  on  the  right  display  should  be  active  if  line  4  is  '1'  and  line  5  is  '0' 
Output  line  6  controls  the  right-hand  decimal  point  on  the  left  display.  It  may  be  driven 
with  an  inverter  or  simply  left  on. 

Keyboard  Connections:  The  keyboard  is  a  simple  calculator  keyboard  available  for 
50$  from  a  local  source.  It  consists  of  12  unencoded  key-switches  arranged  in  four  rows 
of  three  columns  each.  Since  the  wiring  of  the  keyboard  does  not  coincide  with  the  ob- 
served rows  and  columns,  the  program  uses  a  table  to  identify  the  keys.  Tables  16-1 
and  1 6-2  contain  the  input  and  output  connections  for  the  keyboard.  The  decimal  point 
key  is  present  for  operator  convenience  and  for  future  expansion;  the  current  program 
does  not  actually  use  the  key. 

In  an  actual  application,  the  keyboard  would  require  pullup  resistors  to  ensure  that  the 
inputs  would  actually  be  read  as  logic  '1's  when  the  keys  were  not  being  pressed.  It 
would  also  require  current-limiting  resistors  or  diodes  on  the  output  port  to  avoid 
damaging  the  drivers  in  the  case  where  two  outputs  were  driving  against  each  other. 
This  could  occur  if  two  keys  in  the  same  row  were  pressed  at  the  same  time,  thus  con- 
necting two  different  column  outputs. 
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Figure  16-1.   Digital  Stopwatch  I/O  Configuration 


Table  16-1.  Input  Connections  for  Stopwatch  Keyboard 


Input  Bit 

Keys  Connected 

0 

■3'.  -S',  'B- 

1 

2 

,Q, 

3 

■4'.  ■;.  'GO' 

Table  16-2.  Output  Connections  for  Stopwatch  Keyboard 

Output  Bit 

Keys  Connected 

0 

,Q,       .3,  .4. 

1 

■r.  'S',  '9',  'GO' 

2 

■5'.  'e'.  7'.  V 
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Display  Connections:  The  displays  are  seven-segment  displays  with  their  own  in- 
tegral decoders.  A  typical  example  would  be  the  Texas  Instruments  TIL309  device, 
which  has  an  internal  TTL  MSI  chip  with  latch,  decoder,  and  driver.  Clearly,  standard 
seven-segment  displays  would  be  cheaper  but  would  require  some  additional  software 
(the  seven-segment  conversion  routine  shown  in  Chapter  71.  Data  is  entered  into  the 
display  as  a  single  binary  coded  decimal  digit;  the  digits  are  represented  as  shown  in 
Figure  11-15.  The  decimal  point  is  a  single  LED  that  is  turned  on  when  the  decimal 
point  input  is  a  logic  '1'  You  can  find  more  information  about  displays  in  References  10 
and  1 1  at  the  end  of  this  chapter. 

Program  Description: 

The  program  is  modular  and  has  several  subroutines.  The  emphasis  is  on  clarity  and 
generality  rather  than  efficiency;  obviously,  the  program  does  not  utilize  the  full 
capabilities  of  the  Z80  processor.  Each  section  of  the  listing  will  now  be  described  in 
detail. 

1 )  Introductory  Comments 

The  introductory  comments  fully  describe  the  program;  these  comments  are  a 
reference  so  that  other  users  can  easily  apply,  extend,  and  understand  the  pro- 
gram. Standard  formats,  indentations,  and  spacings  increase  the  readability  of  the 
program. 

2)  Variable  Definitions 

All  variable  definitions  are  placed  at  the  start  of  the  program  so  that  they  can  easily 
be  checked  and  changed.  Each  variable  is  placed  in  a  list  alphabetically  with  other 
variables  of  the  same  type;  comments  describe  the  meaning  of  each  variable.  The 
categories  are: 

a)  Memory  system  constants  that  may  vary  from  system  to  system  depending  on 
the  memory  space  allocated  to  different  programs  or  types  of  memories 

b)  Temporary  storage  (RAM)  used  for  variables 

c)  I/O  (PIO)  port  addresses 

d)  Definitions 

The  memory  system  constants  are  placed  in  the  definitions  so  that  the  user  may 
relocate  the  program,  temporary  storage,  and  memory  stack  without  making  any 
other  changes.  The  memory  constants  can  be  changed  to  accommodate  other 
programs  or  to  coincide  with  a  particular  system's  allocation  of  ROM  and  RAM  ad- 
dresses. 

Temporary  storage  is  allocated  by  means  of  DEFS  (Define  Storage)  pseudo-opera- 
tions. An  ORG  (origin)  pseudo-operation  places  the  temporary  storage  locations  in 
a  particular  part  of  memory.  No  values  are  placed  in  these  locations  so  that  the 
program  could  eventually  be  placed  in  ROM  or  PROM  and  the  system  could  be 
operated  from  power-on  reset  without  reloading. 

Each  port  address  occupied  by  a  PIO  is  named  so  that  the  addresses  can  easily  be 
changed  to  handle  varied  configurations.  The  naming  also  serves  to  clearly  dis- 
tinguish control  registers  from  data  registers. 

The  definitions  clarify  the  meaning  of  certain  constants  and  allow  parameters  to 
be  changed  easily.  Each  definition  is  given  in  the  form  (binary,  hex,  octal.  ASCII,  or 
decimal)  in  which  its  meaning  is  the  clearest.  Parameters  (such  as  debounce  time) 
are  placed  here  so  that  they  can  be  varied  with  system  needs. 
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3)  Initialization 

Memory  location  0  (the  reset  location  on  the  Z80  microprocessor)  contains  a  |ump 
to  the  starting  address  of  the  main  program.  The  main  program  can  thus  be 
placed  anywhere  in  memory  and  reached  via  a  "RESET"  signal. 
The  initialization  consists  of  four  steps: 

a)  Place  a  starting  value  in  the  Stack  Pointer.  The  Stack  is  used  only  to  store 
subroutine  return  addresses. 

b)  Configure  the  PIO  control  registers. 

c)  Start  the  number  of  digit  keys  pressed  at  zero. 

d)  Initialize  the  location  where  the  next  digit  key  pressed  will  be  saved  to  the 
start  of  the  digit  key  array.  An  indirect  procedure  is  used,  in  which  KEYAD 
contains  the  address  in  which  the  next  digit  will  be  placed.  Each  time  a  digit 
key  is  recognized,  the  contents  of  KEY.AD  are  incremented  so  that  the  next 
digit  key  will  be  placed  into  the  next  memory  location. 

4)  Look  for  Key  Closure 
Flowchart: 


Key  closures  are  identified  by  grounding  all  the  keyboard  columns  and  then 
checking  for  grounded  rows  (i.e.,  column-to-row  switch  closures).  Note  that  the 
program  does  not  assume  that  the  unused  input  bits  are  all  high:  instead,  the  bits 
attached  to  the  keyboard  are  isolated  with  a  logical  AND  instruction. 

5)    Debounce  Key 

The  program  debounces  the  key  closure  in  software  by  waiting  for  two  millise- 
conds. This  IS  usually  long  enough  for  a  clean  contact  to  be  made.  Subroutine 
DELAY  simply  counts  with  Register  C  for  1  millisecond.  The  number  of  millise- 
conds IS  in  the  Accumulator.  DELAY  would  have  to  be  adjusted  if  a  slower  clock  or 
slower  memories  were  being  used.  You  could  make  the  change  simply  by  redefin- 
ing the  constant  MSCNT. 
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Identify  Key  Closure 
Flowchart: 


C 


Set  kev  table  pointer 
to  KTAB  -  1 

Set  pattern  pointer 
to  PATT 


Ground  a  keyboard 
coiumn  by  output  of 
{pattern  pointer) 


C 


Increment  W  table 
pointer  by  the  number 
of  keys  in  a  column 
(KCOLI  Increment 
^atterr^^nter^fa^ 


Increment  key  table 
pointer  by  1 

Shift  kayboaKi  input 
right  1  bit 


Key  ID  =  i 
{key  table  pointer}  i 

Use  key  table  pointer  | 
to  get  key  ID  I 


3 


The  particular  kev  closed  is  identified  by  grounding  single  columns  and  observing 
whether  a  closure  is  found.  Once  a  closure  is  found  (so  the  kev  column  is  knovi'n), 
the  key  row  can  be  determined  by  shifting  the  input. 

The  patterns  required  to  ground  single  kevboard  columns  are  in  a  table  PATT  in 
memory.  The  final  pattern  in  the  table  is  a  marker  (ECODE)  which  indicates  that  ail 
the  columns  have  been  grounded  without  a  closure  being  found.  This  pattern  also 
indicates  to  the  main  program  that  the  closure  could  not  be  identified  (e.g..  the 
key  closure  ended  or  a  hardware  error  occurred  before  we  could  find  the  closure). 
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The  key  identifications  are  in  table  KTAB  in  memory.  The  KEY 
keys  in  the  first  column  (attached  to  the  least  significant  out-  TABLE 
put  bit)  are  followed  by  those  in  the  second  column,  etc. 
Withm  a  column,  the  key  in  the  row  attached  to  the  least  significant  input  bit  is 
first,  etc.  Thus,  each  time  a  column  is  scanned  without  finding  a  closure,  the  num- 
ber of  keys  in  a  column  (NROWS)  must  be  added  to  the  key  table  pointer  in  order 
to  move  to  the  next  column.  The  key  table  pointer  is  also  incremented  by  one 
before  each  bit  in  the  row  inputs  is  examined;  this  process  stops  when  a  zero  input 
IS  found.  Note  that  the  key  table  pointer  is  started  one  location  before  the  table, 
since  it  is  always  incremented  once  in  the  search  for  the  proper  row. 
If  we  cannot  identify  the  key  closure,  we  simply  ignore  it  and  look  for  another 
closure. 

7)  Act  on  Kay  Identification 

If  the  program  has  enough  digits  (two  in  this  simple  case),  it  looks  only  for  the  GO 
key  and  ignores  all  other  keys.  If  it  finds  a  digit  key,  it  saves  the  value  in  the  key 
array,  increments  the  number  of  digit  keys  pressed,  and  increments  the  key  array 
pointer. 

If  the  entry  is  not  complete,  the  program  must  wait  for  the  key  closure  to  end  so 
that  the  system  will  not  read  the  same  closure  again.  The  user  must  wait  between 
key  closures  (i.e..  release  one  key  before  pressing  another  one).  Note  that  the  pro- 
gram will  identify  double  key  closures  as  one  key  or  the  other,  depending  on 
which  closure  the  identification  routine  finds  first.  An  improved  version  of  this 
program  would  display  digits  as  they  were  entered  and  would  allow  the  user  to 
omit  a  leading  or  trailing  zero,  (i.e.,  kev  in  "7",  "GO"  to  get  a  count  of  seven- 
tenths  of  a  minute). 

8)  Set  Up  Display  Output 

The  digits  are  placed  in  registers  or  memory  locations  with  bit  4  set  so  that  the 
output  is  sent  to  the  displays.  Bits  5  and  6  are  set  for  the  most  significant  digit  to 
direct  the  output  to  the  left  display  and  to  turn  on  the  decimal  point. 

9)  Pulse  the  LED  Displays 

Each  display  is  turned  on  for  two  milliseconds.  This  process  is  repeated  1500 
times  in  order  to  get  a  total  delay  of  0.1  minutes,  or  6  seconds.  The  pulses  are  fre- 
quent enough  so  that  the  LED  displays  appear  to  be  lit  continuously. 
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Decrement  Display  Count 
Flowchart: 


fSght  Displav  =  9 


End  of  timer 
program 


c 


The  value  of  the  less  significant  digit  is  reduced  by  one.  If  this  affects  bit  4 
(LEDON  —  used  to  turn  the  displays  on),  the  digit  has  become  negative.  A  borrow 
must  then  be  obtained  from  the  more  significant  digit.  If  the  borrow  from  the  more 
significant  digit  affects  bit  4.  the  count  has  gone  past  zero  and  the  countdown  is 
finished.  Otherwise,  the  program  sets  the  value  of  the  less  significant  digit  to  9 
and  continues. 

Note  that  comments  describe  both  sections  of  the  program  and  individual  statements. 
The  comments  explain  what  the  program  is  doing,  not  what  specific  instruction  codes 
do.  Spacing  and  indentation  have  been  used  to  improve  readability. 
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PROGRAM  NAME:  TIMER 
.DATE  OF  PROGRAM;  10/24/78 
PROGRAMMER:  LANCE  A.  LEVENTHAL 
:PROGRAM  REQUIREMENTS:  Dl  (209)  BYTES 
:RAM  REQUIREMENTS:  5  BYTES 

:l/0  REQUIREMENTS:  1  INPUT  PORT.  1  OUTPUT  PORT  (1  Z80  PIO) 


;THIS  PROGRAM  IS  A  SOFTWARE  TIMER  WHICH  ACCEPTS  INPUTS  FROM  A 
.    CALCULATOR-LIKE  KEYBOARD  AND  THEN  PROVIDES  A  STOPWATCH 
.    COUNTDOWN  ON  TWO  7-SEGMENT  LED  DISPLAYS  IN  MINUTES  AND  TENTHS 
.    OF  MINUTES 

:KEYBOARD 

:A  12-KEY  KEYBOARD  IS  ASSUMED 

.THREE  COLUMN  CONNECTIONS  ARE  OUTPUTS  FROM  THE  PROCESSOR 
.    SO  THAT  A  COLUMN  OF  KEYS  CAN  BE  GROUNDED 
;FOUR  ROW  CONNECTIONS  ARE  INPUTS  TO  THE  PROCESSOR  SO  THAT 
.    COMPLETED  CIRCUITS  CAN  BE  IDENTIFIED 

;THE  KEYBOARD  IS  DEBOUNCED  BY  WAITING  FOR  TWO  MILLISECONDS 
.    AFTER  A  KEY  CLOSURE  IS  RECOGNIZED 

:A  NEW  KEY  CLOSURE  IS  IDENTIFIED  BY  WAITING  FOR  THE  OLD  ONE 

:    TO  END  SINCE  NO  STROBE  IS  USED 

:THE  KEYBOARD  COLUMNS  ARE  CONNECTED  TO  BITS  0 

.    TO  2  OF  THE  PIO  B  PORT 

.THE  KEYBOARD  ROWS  ARE  CONNECTED  TO  BITS  0 
.    TO  3  OF  THE  PIO  A  PORT 

:DISPLAYS 

:TWO  7-SEGMENT  LED  DISPLAYS  ARE  USED  WITH  SEPARATE  DECODERS 
:    (7447  OR  7448  DEPENDING  ON  THE  TYPE  OF  DISPLAY) 
,THE  DECODER  DATA  INPUTS  ARE  CONNECTED  TO  BITS  0  TO  3 
:    OF  THE  PIO  B  PORT 

:BIT  4  OF  THE  PIO  B  PORT  IS  USED  TO  ACTIVATE  THE  LED 
:    DISPLAYS  (BIT  4  IS  1  TO  SEND  DATA  TO  LEDS) 
:BIT  5  OF  THE  PIO  B  PORT  IS  USED  TO  SELECT  WHICH 
,    LED  IS  BEING  USED  (BIT  5  IS  1  IF  THE  LEADING  DISPLAY 
.    IS  BEING  USED,  0  IF  THE  TRAILING  DISPLAY  IS  BEING  USED) 
:BIT  6  OF  THE  PIO  B  PORT  IS  USED  TO  LIGHT  THE  DECIMAL 
.    POINT  LED  ON  THE  LEADING  DISPLAY  (BIT  6  IS  1  IF 
.    THE  DISPLAY  IS  TO  BE  LIT) 

: METHOD 

;STEP  1  -  INITIALIZATION 

,    THE  MEMORY  STACK  POINTER  (USED  FOR  SUBROUTINE  RETURN 

,    ADDRESSES)  IS  INITIALIZED.  THE  NUMBER  OF  DIGIT  KEYS  PRESSED  IS  SET 

.    TO  ZERO,  AND  THE  ADDRESS  INTO  WHICH  THE  NEXT  DIGIT  KEY 

.    IDENTIFICATION  WILL  BE  PLACED  IS  INITIALIZED  TO  THE  FIRST  ADDRESS 

:    IN  THE  DIGIT  KEY  ARRAY 

:STEP  2  -  LOOK  FOR  KEY  CLOSURE 

.    ALL  KEYBOARD  COLUMNS  ARE  GROUNDED  AND  THE  KEYBOARD  ROWS 
:    ARE  EXAMINED  UNTIL  A  CLOSED  CIRCUIT  IS  FOUND 
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STEP  3  -  DEBOUNCE  KEY  CLOSURE 
A  WAIT  OF  2  MS  IS  INTRODUCED  TO  ELIMINATE  KEY  BOUNCE 

STEP  4  -  IDENTIFY  KEY  CLOSURE 
THE  KEY  CLOSURE  IS  IDENTIFIED  BY  GROUNDING  SINGLE  KEYBOARD 
COLUMNS  AND  DETERMINING  THE  ROW  AND  COLUMN  OF  THE  KEY 
CLOSURE.  A  TABLE  IS  USED  TO  ENCODE  THE  KEYS  ACCORDING  TO  THEIR 
ROW  AND  COLUMN  NUMBER 

IN  THE  KEY  TABLE,  THE  DIGITS  ARE  IDENTIFIED  BY  THEIR  VALUES, 
THE  DECIMAL  POINT  KEY  IS  NO.  10,  AND  THE  "GO"  KEY  IS  NO.  1 1 
STEP  5  -  SAVE  KEY  CLOSURE 
DIGIT  KEY  CLOSURES  ARE  SAVED  IN  THE  DIGIT  KEY  ARRAY  UNTIL 
TWO  DIGITS  HAVE  BEEN  IDENTIFIED.  DECIMAL  POINTS,  FURTHER  DIGITS, 
AND  CLOSURES  OF  THE  "GO"  KEY  BEFORE  TWO  DIGITS  HAVE  BEEN 
IDENTIFIED  ARE  IGNORED 

AFTER  TWO  DIGITS  HAVE  BEEN  FOUND.  THE  "GO"  KEY  IS  USED  TO 

,    START  THE  COUNTDOWN  PROCESS 

STEP  6  -  COUNT  DOWN  TIMER  INTERVAL  ON  LEDS 

A  COUNTDOWN  IS  PERFORMED  ON  THE  LEDS  WITH  THE  LEADING  DIGIT 
REPRESENTING  THE  REMAINING  NUMBER  OF  MINUTES  AND  THE  TRAILING 
DIGIT  REPRESENTING  THE  REMAINING  NUMBER  OF  TENTHS  OF  MINUTES 


TIMER  VARIABLE  DEFINITIONS 
MEMORY  SYSTEM  CONSTANTS 


BEGIN  EQU 


50H 


LASTM     EQU  1000H 
TEMP      EQU  800H 
:RAM  TEMPORARY  STORAGE 

ORG  TEMP 
KEYAD:    DEFS  2 


KEYNO:  DEFS 


NKEYS;  DEFS 


:l/0  UNITS  AND  PIO  ADDRESSES 


PIODRA  EQU 
PIOCRA  EQU 
PIQDRB  EQU 

PIOCRB  EQU 

:DEFINITIONS 

DECPT  EQU 


OEOH 
0E2H 
DE1H 

0E3H 


; BEGIN  IS  STARTING  MEMORY  LOCATION 
.    FOR  PROG 

;LASTM  IS  STARTING  STACK  ADDRESS 
;TEMP  IS  START  OF  RAM  STORAGE 


;KEYAD  HOLDS  THE  ADDRESS  IN  THE 
:    DIGIT  KEY  ARRAY  IN  WHICH  THE 
,    IDENTIFICATION  OF  THE  NEXT  DIGIT 
;    KEY  WILL  BE  PLACED 
:KEYNO  IS  THE  DIGIT  KEY  ARRAY  -  IT 
.    HOLDS  THE  IDENTIFICATIONS  OF  THE 
.    DIGIT  KEYS  THAT  HAVE  BEEN  PRESSED 
:NKEYS  HOLDS  NUMBER  OF  DIGIT  KEYS 
,  PRESSED 


■.INPUT  PIO  FOR  KEYBOARD 

:OUTPUT  PIO  FOR  KEYBOARD  AND 
;  DISPLAY 


.BIT  POSITION  TO  TURN  ON  DECIMAL 
;    POINT  LED 


16-10 


tL-UUc 

cUU 

Urrn 

,tnnUn  L-UUb  Ir  lU  nUU  1  MNt  UUto  NU  1  rirMU 

bUU 

1 1 

,!UbN  1  IriLA  1  iUN  NUMDhH  rOn    bU  KbY 

LhUON 

bUU 

4 

,dII  rUbi  I  IUN  lUbtNUUUirUI   1  U  LbUb 

LtUbL 

bUU 

5 

.DM  PUbl  i  !uN  lUbtLbCI  LbAUlNb 

UioPLAY 

ivISCNT 

EQU 

0F9H 

;COUNT  NbEDtD  TO  Give  1  Mb  DELAY  TIME 

MXKcY 

EQU 

2 

:MAXIMUM  NUMBER  OF  ulbIT  KEY 

CLOSURES  USED 

NROWS 

EQU 

4 

iNUMBER  OF  ROWS  IN  KEYBOARD  OR  KEYS 

;    IN  COLUMN 

OPEN 

EQU 

00001 11  IB 

;INPUT  FROM  KEYBOARD  IF  NO  KEY 

.  CLOSED 

TPULS 

EQU 

2 

: NUMBER  OF  MS  BETWEEN  DIGIT  DISPLAYS 

TWAIT 

EQU 

2 

:NUMBER  OF  MS  TO  DEBOUNCE  KEYS 

ORG 

0 

: RESET  ROUTINE  TO  REACH  TIMER  PROGRAM 

JP 

BEGIN 

;FIND  TIMER  PROGRAM 

:INITIALIZATION  OF  TIMER  PROGRAM 

ORG 

BEGIN 

LP 

A.01001111B 

;MAKE  PIO  PORT  A  INPUT 

OUT 

(PIOCRA),A 

LD 

A.00001111B 

:MAKE  PIO  PORT  B  OUTPUT 

OUT 

(PIOCRBJ.A 

LD 

SP.LASTM 

;PUT  STACK  AT  END  OF  MEMORY 

SUB 

A 

LD 

(NKEYS).A 

;NUMBER  OF  DIGIT  KEYS  PRESSED  =  ZERO 

LD 

HLKEYNO 

iSTARTING  LOCATION  FOR  DIGIT  KEYS 

LD 

(KEYADj.HL 

;SCAN  KEYBOARD  LOOKING  FOR  KEY  CLOSURE 

START: 

CALL 

SCANC 

;WAIT  FOR  KEY  CLOSURE 

:WAIT  FOR  KEY  TO 

BE  DEBOUNCED 

LD 

A.TWAIT 

:GET  DEBOUNCE  TIME  IN  MS 

CALL 

DELAY 

:WAIT  FOR  KEY  TO  STOP  BOUNCING 

-.IDENTIFY  WHICH  KEY  WAS  PRESSED 

CALL 

IDKEY 

-.IDENTIFY  KEY  CLOSURE 

CP 

ECODE 

;WAS  KEY  CLOSURE  IDENTIFIED? 

JR 

Z.START 

:N0.  WAIT  FOR  ANOTHER  CLOSURE 

;ACT  ON  KEY  IDENTIFICATION 
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LD 

B,A 

SAVE  KEY  NUMBER 

LD 

HL.NKEYS 

CHECK  FOR  MAXIMUM  NUMBER  OF  DIGIT 
KEYS 

LD 

A,(HL) 

CP 

MXKEY 

HAS  MAXIMUM  BEEN  REACHED' 

JR 

Z.KEYF 

YES,  LOOK  FOR  GO  KEY 

LD 

A,B 

NO,  LOOK  FOR  DIGIT  KEYS  ONLY 

CP 

10 

IS  THIS  KEY  A  DIGIT' 

JR 

NCWAITK 

NO,  IGNORE  IT 

INC 

(HU 

YES,  INCREMENT  DIGIT  KEY  COUNTER 

LD 

HL,(KEYAD) 

SAVE  KEY  NUMBER  IN  ARRAY 

LD 

(HL),A 

INC 

HL 

LQ 

(KEYAD),HL 

■.WAIT  FOR  CURRENT  KEY  CLOSURE  TO  END 

WAITK;    CALL       SCANO  :WAIT  FOR  KEY  TO  BE  RELEASED 

JR  START  :G0  LOOK  FOR  NEXT  KEY 

;LOOK  FOR  GO  KEY  IF  ENOUGH  DIGITS  FOUND 

KEYF.      LD  A,B  ;GET  NUMBER  OF  KEY  PRESSED 

CP  GOKEY  ;IS  IT  "GO"  KEY? 

JR  NZ.WAITK         :N0.  IGNORE  IT 

;PUT  DIGITS  INTO  REGISTERS  FOR  DISPLAY 


LD 

HLKEYNO 

LD 

D,(HU 

:GET  LEADING  DIGIT 

SET 

DECPT,D 

:TURN  ON  DECIMAL  POINT 

SET 

LEDON,D 

;SET  OUTPUT  TO  LEDS 

SET 

LEDSL,D 

;SELECT  LEADING  DISPLAY 

INC 

HL 

LD 

E,(HU 

:GET  TRAILING  DIGIT 

SET 

LEDON,E 

:SET  OUTPUT  TO  LEDS 

;PULSE  THE  LED  DISPLAYS 


LD 

CPIODRB 

;GET  OUTPUT  PORT  ADDRESS 

LEDLP- 

LD 

H,6 

.SET  COUNTERS  FOR  6  SECONDS 

TLOOP: 

LD 

B,250 

LDPUL. 

OUT 

(C).D 

iOUTPUT  LEADING  DIGIT  TO  LED  1 

LD 

A.TPULS 

:DELAY  BETWEEN  DIGITS 

CALL 

DELAY 

OUT 

(C),E 

iOUTPUT  TRAILING  DIGIT  TO  LED  2 

LD 

A.TPULS 

:DELAY  BETWEEN  DIGITS 

CALL 

DELAY 

DJNZ 

LDPUL 

DEC 

H 

JR 

NZ.TLOOP 

;DECREMENT  COUNT  ON  LED  DISPLAYS 
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DEC  E  ;COUNT  DOWN  TRAILING  DIGIT 

BIT  LEDON.E  ;IS  TRAILING  DIGIT  PAST  ZERO? 

JR  NZ.LEDLP  :N0,  CONTINUE 

DEC  D  -.COUNT  DOWN  LEADING  DIGIT 

BIT  LEDON.D  :IS  LEADING  DIGIT  PAST  ZERO? 

JP  Z.BEGIN  :YES,  WAIT  FOR  NEXT  TIMING  TASK 

LD  E,9  :N0,  SET  TRAILING  DIGIT  TO  9 

SET  LEDON.E  ;SET  OUTPUT  TO  LEDS 

JR  LEDLP  ;RETURN  TO  DISPLAY  SECTION 

iSUBROUTINE  SCANC  SCANS  THE  KEYBOARD  WAITING  FOR  A  KEY  CLOSURE 
;ALL  KEYBOARD  INPUTS  ARE  GROUNDED 

SCANC;   SUB  A  .GROUND  ALL  KEYBOARD  COLUMNS 

OUT  (PIODRB).A 

IN  A.fPIODRA) 

AND  OPEN  ilGNORE  UNUSED  INPUTS 

CP  OPEN  :ARE  ANY  KEYS  CLOSED? 

JR  Z.SCANC  :N0.  CONTINUE  SCANNING 
RET 

;SUBROUTINE  DELAY  WAITS  FOR  THE  NUMBER  OF  MILLISECONDS  SPECIFIED 
;    IN  REGISTER  A 

DELAY:    EXX  ;SAVE  USER  REGISTERS 

DLY1 ;      LD  C.MSCNT  :LOAD  REGISTER  C  FOR  1  MS 

WTLP-     DEC  C  :WAIT  1  MS 

JR  NZ.WTLP 

DEC  A  :COUNT  DOWN  NUMBER  OF  MS 

JR  NZ.DLY1 

EXX  -.RESTORE  USER  REGISTERS 
RET 

:SUBROUTINE  IDKEY  DETERMINES  THE  ROW  AND  COLUMN  NUMBER  OF  THE 
,    KEY  CLOSURE  AND  IDENTIFIES  THE  KEY  BY  USING  A  TABLE 

IDKEY;     LD  BC.PATT  ;POINT  TO  SCAN  PATTERNS 

LD  HL,KTAB-1  ;START  KEY  TABLE  POINTER 

LD  DE.NROWS  ;GET  NUMBER  OF  KEYS  IN  A  COLUMN 

;SCAN  KEYBOARD  COLUMNS  SUCCESSIVELY  LOOKING  FOR  CLOSURE 

FCOL.      LD  A.(BC)  :GET  PATTERN  TO  GROUND  COLUMN 

CP  ECODE  :ALL  COLUMNS  SCANNED? 

RET  Z  ;YES.  RETURN  WITH  ERROR  CODE 

OUT  (PIODRB).A  :SCAN  COLUMN 

IN  A.(PIODRA) 

AND  OPEN  ;IGNORE  UNUSED  INPUTS 

CP  OPEN  :ANY  KEYS  IN  THIS  COLUMN  CLOSED? 

JR  NZ.FROW  ;YES,  GO  DETERMINE  CLOSURE  ROW 

ADD  HL.DE  ;N0.  MOVE  KEY  TABLE  POINTER  TO 

;    NEXT  COLUMN 

INC  BC  :POINT  TO  NEXT  SCAN  PATTERN 

JR  FCOL 


16-13 


;DETERMINE  ROW  NUMBER  OF  CLOSURE 
HL 

CFROW 

IDENTIFY  KEY  FROM  TABLE 


FROW:  INC 
RRCA 
JR 


MOVE  KEY  TABLE  POINTER  TO  NEXT  ROW 
NEXT  ROW  GROUNDED' 
NO,  KEEP  LOOKING 


LD 
RET 


A,(HL) 


;GET  KEY  NUMBER 


;SCAN  PATTERNS  USED  TO  GROUND  ONE  COLUMN  AT  A  TIME 

;ERROR  PATTERN  USED  TO  INDICATE  THAT  ALL  COLUMNS  HAVE  BEEN  SCANNED 

;THE  COLUMN  ATTACHED  TO  OUTPUT  BIT  0  IS  SCANNED  FIRST,  THEN 

.    THE  ONE  ATTACHED  TO  OUTPUT  BIT  1.  ETC. 


PATT  DEFB 
DEFB 
DEFB 
DEFB 

: KEYBOARD  TABLE 


0000011  OB 
00000101 B 
0000001  IB 
ECODE 


:COLUMNS  ARE  PRIMARY  INDEX,  ROWS  SECONDARY  INDEX 

;THE  KEYS  IN  THE  COLUMN  ATTACHED  TO  OUTPUT  BIT  0  ARE  FOLLOWED 

,    BY  THOSE  IN  THE  COLUMN  ATTACHED  TO  OUTPUT  BIT  1,  ETC.  WITHIN 

.    A  COLUMN,  THE  KEY  ATTACHED  TO  INPUT  BIT  0  IS  FIRST  FOLLOWED 

;    BY  THE  ONE  ATTACHED  TO  INPUT  BIT  1,  ETC. 

,THE  DIGIT  KEYS  ARE  0  TO  9,  DECIMAL  POINT  IS  10.  GO  IS  1 1 

KTAB: 


DEFB 

3 

CO,RO 

DEFB 

2 

C0,R1 

DEFB 

0 

C0,R2 

DEFB 

4 

C0,R3 

DEFB 

8 

CI.RO 

DEFB 

9 

01, R1 

DEFB 

1 

C1.R2 

DEFB 

11 

C1,R3 

DEFB 

5 

C2.R0 

DEFB 

6 

C2,R1 

DEFB 

7 

C2,R2 

DEFB 

10 

C2,R3 

:SUBROUTINE  SCANO  SCANS  THE  KEYBOARD  WAITING  FOR  KEY  CLOSURE  TC 
,    END  SO  NEXT  CLOSURE  CAN  BE  FOUND 


SUB 

A 

;GROUND  ALL  KEYBOARD  COLUMNS 

OUT 

(PIODRB),A 

IN 

A,(PIODRA) 

AND 

OPEN 

;IGNORE  UNUSED  INPUTS 

CP 

OPEN 

;ARE  ANY  KEYS  STILL  CLOSED? 

JR 

NZ.SCANO 

;YES,  CONTINUE  SCANNING 

RET 

END 
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PROJECT  #2:  A  Digital  Thermometer 

Purpose:  This  project  is  a  digital  thermometer  which  shows  the  temperature  In 
degrees  Celsius  on  two  seven-segment  displays. 

Hardware:  The  project  uses  one  input  port  and  one  output  port,  two  seven-segment 
displays,  a  74LS04  inverter,  a  74LS00  NAND  gate  or  a  74LS08  AND  gate  depending  on 
the  polarity  of  the  displays,  an  Analog  Devices  AD7570J  8-bit  monolithic  A/D  con- 
verter, an  LM31 1  comparator,  and  various  peripheral  drivers,  resistors,  and  capacitors 
as  required  by  the  displays  and  the  converter.  (See  Chapter  1 1  and  Reference  1  at  the 
end  of  this  chapter  for  discussions  of  A/D  converters.) 

Figure  16-2  shows  the  organization  of  the  hardware.  Output  line  7  from  PIO  Port  B  is 
used  to  send  a  Start  Conversion  signal  to  the  A/D  converter.  Input  lines  0  through  7  are 
attached  directly  to  the  eight  digital  data  lines  from  the  converter.  Output  lines  0 
through  3  are  used  to  send  BCD  digits  to  the  seven-segment  decoder/drivers.  Output 
line  4  activates  the  displays  and  output  line  5  selects  the  left  or  right  display  (line  5  is  '1' 
for  the  left  display). 

The  analog  part  of  the  hardware  is  shown  in  Figure  16-3.  The 
thermistor  simply  provides  a  resistance  that  depends  on  tem- 
perature. Figure  1 6-4  is  a  plot  of  the  resistance  and  Figure  1 6-5 
shows  the  range  of  current  values  over  which  the  resistance  is 
linear.  The  conversion  to  degrees  Celsius  in  the  program  is  performed  with  a  calibration 
table.  The  two  potentiometers  can  be  adjusted  to  scale  the  data  properly.  A  clock  for 
the  A/D  converter  is  generated  from  an  RC  network.  The  values  are  R7=33  kft  and 
CI  =1000  pF,  so  that  the  clock  frequency  Is  about  75  kHz.  At  this  frequency,  the  max- 
imum conversion  time  for  eight  bits  is  about  50  microseconds.  A  much  longer  delay  is 
allowed  for  conversion  so  that  no  check  for  the  end  of  conversion  is  necessary.  The  8- 
bit  version  of  the  converter  requires  the  following  special  connections.  The  eight  data 
lines  are  DB2  through  DB9  (DB1  Is  always  high  during  conversion  and  DBO  low).  The 
Short  Cycle  8-bit  input  (pin  26-SC8)  Is  tied  low  so  that  only  an  8-bit  conversion  Is  per- 
formed. In  the  present  case.  High  Byte  Enable  (pin  20-HBEN)  and  Low  Byte  Enable  (pin 
21-LBEN)  were  both  tied  high  so  that  the  data  outputs  were  always  enabled. 

The  A/D  converter  uses  the  successive  approximation  method  to  perform  a  conversion. 
The  ADC's  data  register  is  connected  to  the  inputs  of  an  Internal  D/A  converter  whose 
output  (available  at  0UT1  and  0UT2)  is  compared  to  the  analog  input.  When  a  conver- 
sion IS  initiated,  the  ADC  logic  sets  the  data  register  to  all  zeros  with  the  exception  of 
the  most  significant  bit  (MSB),  which  is  set  to  one.  If  the  analog  input  is  less  than  the 
resulting  internally  generated  analog  value,  then  the  MSB  is  reset  to  zero:  otherwise  it 
remains  a  one.  The  next  most  significant  bit  Is  then  set  to  one  and  the  process  repeated 
until  all  eight  bits  have  been  "tested"  In  this  way.  After  the  eighth  cycle,  the  value  in  the 
register  is  the  value  which  most  closely  corresponds  to  the  analog  input. 

This  method  is  fast,  but  it  requires  that  the  input  be  stable  during  the  conversion  pro- 
cess. Rapidly  changing  or  noisy  inputs  would  require  additional  signal  conditioning.  The 
references  at  the  end  of  this  chapter  describe  more  accurate  methods  for  handling 
analog  I/O. 


THERMOMETER 

ANALOG 

HARDWARE 
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B4 

(PIO 
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Port  B) 

B2 
Bl 
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A7 
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A4 

(PIO 

A3 

Port  A) 

At 

Ao 

Start 
Conversion 


A/D 
Converter 


Analog  Input - 


Do       D2  D3 

Display 
and 
Dnver 
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Dispiav 
and 
Dnver 
(right) 


Figure  16-2.  I/O  Configuration  for  a  Digital  Thermometer 
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R6 

50  kn 

OFFSET  ADJ 


+  15V 

o 


From  PIO  Port  B,  bit  7  ' 
{not  used) 


26 


f  5  V 
O 


vcc 

Vref 

OUTl 

0UT2, 

CLOCK 

COMP 

AD7570J 

SRO 

A/D 

ConvfirtGr 

SYNC 

DB9 

ANALOG 

DBS 

INPUT 

DB7 

DB6 

HBEN 

DBS 

LBEN 

DB4 

STRT 

DB3 

BUSY 

DB2 

BSEN 

DBl 

SC8 

DBO 

AGND 

DGND 

n  ft  n 


R5 
2  Mn 


Note:  If  positive  Vpgp  is  used,  the  ANALOG  INPUT  range  is  0  to  -VRgp,  and  the 

COMPARATOR'S  (-1  input  should  be  connected  to  OUTl  (pin  41  of  the  AD7570. 

Rj  IS  the  thermistor.  The  analog  input  from  the  voltage  divider  is: 
Rp   


Rg  +  RT 

Since  Rp  =  68  kfl,  the  input  is:     1.02  Mfl 


Hj  +  68  kn 

Rj  has  a  minimum  value  of  34  kn  (T=50"C  see  Figure  16-4}  so  full  scale  is  10  Voit. 


Figure  16-3.  Digital  Thermometer  Analog  Hardware 
16-17 





T(°C1 

R  (Ohml 

0 

365  000 

25 

100  000 

BO 

34  000 

100 

6  000 

25 

Temperature  C^} 


Figure  16-4.  Thermistor  Characteristics 
{Fenwa!  GA51J1  Bead) 


The  curve  is  linear  (i.e..  the  resistance  is 
independent  of  current!  for  currents  less 
than  0.1  milliampere. 


!  (mtniamiwre) 


Figure  16-5.  Typical  E-!  Curve  for  Thermistor  {25°C) 
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General  Program  Flowchart* 


=r- 

Send  Start 
Conversion  signal 
to  A/D  converter 

~~r~ 

Wat  1  ms 


Read  data  from 
A/D  converter 

Convert  data  to 
degrees  Ceisms 

Display 
temperature  on 
L£Ds  for  six  seconds 
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Program  Description: 

1 )  Initialization 

Location  0  (the  Z80  microprocessor  RESET  location)  contains  a  Jump  to  the  starting 
address  of  the  main  program.The  initialization  configures  the  PIO  control  registers 
and  starts  the  Stack  Pointer  at  the  highest  address  in  RAM.  The  Stack  is  used  only 
to  store  subroutine  return  addresses. 

2)  Send  START  CONVERSION  Signal  to  A/D  Converter 

The  CPU  pulses  the  START  CONVERSION  line  bv  first  placing  a  'V  on  line  7  of  PIO 
Port  B  and  then  placing  a  '0'  on  that  line.  Each  input  from  the  converter  requires  a 
starting  pulse. 

3)  Wait  1  ms  for  Conversion 

A  delay  of  1  ms  after  the  START  CONVERSION  pulse  guarantees  a  completed  con- 
yersion.  Actuallv,  the  converter  takes  only  a  maximum  of  100  microseconds  for  an 
8-bit  conversion.  We  could  reduce  the  delay  by  checking  the  BUSY  signal  from  the 
converter  This  signal  is  either  a  'V  (conversion  complete)  or  '0'  (conversion  in 
progress)  if  the  BUSY  ENABLE  line  is  addressed.  In  the  present  case  there  is  no 
reason  to  speed  the  conversion  process.  Clearly,  interrupts  could  be  used  w/ith 
BUSY  tied  to  the  PIO  STROBE  line. 

4)  Read  Data  from  A/D  Converter 

Reading  the  data  involves  a  single  input  operation.  We  should  note  that  the  Analog 
Devices  .AD7570J  has  an  Enable  input  and  tristate  outputs  so  that  it  could  be  tied 
directly  to  the  microprocessor  Data  Bus. 

The  7570  converter  is,  of  course,  underutilized  in  this  particular  application,  partic- 
ularly since  we  are  interfacing  it  to  theZSO  processor  through  a  PIO.  A  simpler  8-bit 
A/D  converter  such  as  the  National  5357  device  would  do  the  job  at  lower  cost: 
this  device  is  available  in  an  1 8-pin  package,  has  a  START  CONVERSION  input,  and 
provides  tristate  outputs.  It  also  has  output  latches  and  an  END  OF  CONVERSION 
output  signal. 
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Convert  Data  to  Degrees  Celsius 
Flowchart: 


c 


Value  =  Data  recaived 
from  A/D  converter 
index    =  0 

Pointer.  =  Start  of  table 


index  =  Index  +  1 
Pointer  =  Pointer  +  1 


Temperature  =  index 

c 


The  conversion  uses  a  table  that  contains  the  largest  in-  USING  A 

put  value  corresponding  to  a  given  temperature.  The  pro-  CALIBRATION 
gram  searches  the  table,  looking  for  a  value  greater  than  TABLE 
or  equal  to  the  value  received  from  the  converter.  The  first 

such  value  it  finds  corresponds  to  the  required  temperature:  that  is,  if  the  tenth 
entry  is  the  first  value  larger  than  or  equal  to  the  data,  the  temperature  is  10 
degrees.  This  search  method  is  inefficient  but  adequate  for  the  present  applica- 
tion. 

Note  that  we  must  keep  the  entry  number  in  decimal  rather  than  binary.  The  in- 
struction sequence  "ADD  A.I  .  DAA"  keeps  the  index  as  tw/o  decimal  digits  in- 
stead of  a  binary  number.  For  example,  the  entry  number  after  9  (00001001  bin- 
ary) will  be  decimal  10  (00010000  BCD)  rather  than  binary  ten  (00001010).  The 
reason  for  this  is  that  we  plan  to  display  the  temperature  as  two  decimal  digits  and 
would  have  to  convert  it  from  binary  to  decimal  otherwise. 
The  table  could  be  obtained  by  calibration  or  by  a  mathematical  approximation. 
The  calibration  method  is  simple,  since  the  thermometer  must  be  calibrated  any- 
way. The  table  occupies  one  memory  location  for  each  temperature  value  to  be 
displayed.^ 

To  calibrate  the  thermometer,  you  must  first  adjust  the  potentiometers  to  produce 
the  proper  overall  range  and  then  determine  the  converter  output  values  corres- 
ponding to  specific  temperatures. 
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Prepare  Data  for  Display 
Flowchart: 


The  least  significant  digit  is  masl<ed  off.  We  set  the  bit  that 
turns  on  the  displays.  The  result  is  saved  in  Register  E. 

The  only  difference  for  the  most  significant  digit  is  that  a  lead- 
ing zero  IS  blanked  (i.e.,  the  displays  show  "blank  7"  rather 
than  "07"  for  7°C).  This  simply  inyolyes  not  setting  the  bit  that  turns  on  the  dis- 
plays if  the  digit  is  zero.  The  result  is  saved  in  Register  D. 


BLANKING 
A  LEADING 
ZERO 
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Display  Temperature  for  Six  Seconds 
Flowchart: 


f  Stan  J 

Count  =  TSAMP 


E 


Send  most 
significant  digit 
to  left  display 


Send  least 
significant  digit 
to  right  display 


I 


Count  =  Count  -  1 


Each  display  is  pulsed  often  enougn  so  that  it  appears  to  be  lit  contmuousiv.  If 
TPULS  were  made  longer  (sav  50  nns),  the  displays  would  appear  to  flash  on  and 
off. 

The  program  uses  a  16-blt  counter  to  count  the  time  between  temperature  sam- 
ples. The  Z80  has  instructions  to  increment  or  decrement  1 6-bit  register  pairs  or  in- 
dex registers.  However,  these  instructions  do  not  affect  the  flags,  so  there  is  no  way 
to  directly  determine  when  the  counter  reaches  zero.  So  we  make  this  determina- 
tion by  logically  ORing  the  eight  most  significant  and  the  eight  least  significant  bits 
of  the  counter.  If  that  result  is  zero,  the  16-bit  counter  is  zero. 
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;PROGRAM  NAME:  THERMOMETER 
; DATE  OF  PROGRAM:  10/20/78 
;PROGRAMMER:  LANCE  A.  LEVENTHAL 
:PROGRAM  MEMORY  REQUIREMENTS:  154  BYTES 
:RAM  REQUIREMENTS:  NONE 

:i/0  REQUIREMENTS:  1  INPUT  PORT,  1  OUTPUT  PORT  (1  Z80  PIO) 

;THIS  PROGRAM  IS  A  DIGITAL  THERMOMETER  THAT  ACCEPTS  INPUTS  FROM 
,    AN  A/D  CONVERTER  ATTACHED  TO  A  THERMISTOR,  CONVERTS  THE  INPUT 
,    TO  DEGREES  CELSIUS.  AND  DISPLAYS  THE  RESULTS  ON  TWO 
:    SEVEN-SEGMENT  LED  DISPLAYS 

;A/D  CONVERTER 

:THE  A/D  CONVERTER  IS  AN  ANALOG  DEVICES  7570J  MONOLITHIC  CONVERTER 
,    WHICH  PRODUCES  AN  8-BIT  OUTPUT 

,THE  CONVERSION  PROCESS  IS  STARTED  BY  A  PULSE  ON  THE  START 
:    CONVERSION  LINE  (BIT  7  OF  PIO  PORT  B) 

:THE  CONVERSION  IS  COMPLETED  IN  50  MICROSECONDS  AND  THE 
:    DIGITAL  DATA  IS  LATCHED 

iDISPL.AYS 

.TWO  SEVEN-SEGMENT  LED  DISPLAYS  ARE  USED  WITH  SEPARATE  DECODERS 

:    (7447  OR  7448  DEPENDING  ON  THE  TYPE  OF  DISPLAY) 

;THE  DECODER  DATA  INPUTS  ARE  CONNECTED  TO  BITS  0  TO  3  OF 

:    PIO  PORT  B 

;BIT  4  OF  PIO  PORT  B  IS  USED  TO  ACTIVATE  THE  LED  DISPLAYS 
:    (BIT  4  IS  1  TO  SEND  DATA  TO  LEDS) 

;BIT  5  OF  PIO  PORT  B  IS  USED  TO  SELECT  WHICH  LED  IS  BEING 
;    USED  (BIT  5  IS  1  IF  THE  LEADING  DISPLAY  IS  BEING  USED. 
.    0  IF  THE  TRAILING  DISPLAY  IS  BEING  USED) 

; METHOD 

:STEP  1  -  INITIALIZATION 

.    THE  MEMORY  STACK  (USED  FOR  SUBROUTINE  RETURN  ADDRESSES)  IS 
,  INITIALIZED 

:STEP  2  -  PULSE  START  CONVERSION  LINE 

:    THE  A/D  CONVERTER'S  START  CONVERSION  LINE  (BIT  7  OF  PIO 
;    PORT  B)  IS  PULSED 

:STEP  3  -  WAIT  FOR  A/D  OUTPUT  TO  SETTLE 

:    A  WAIT  OF  1  MS  ALLOWS  FOR  COMPLETION  OF  THE  CONVERSION 

:STEP  4  -  READ  A/D  VALUE,  CONVERT  TO  DEGREES  CELSIUS. 

:    A  TABLE  IS  USED  FOR  CONVERSION  IT  CONTAINS  THE  MAXIMUM 

;    INPUT  VALUE  FOR  EACH  TEMPERATURE  READING 

STEP  5  -  DISPLAY  TEMPERATURE  ON  LEDS 

THE  TEMPERATURE  IS  DISPLAYED  ON  THE  LEDS  FOR  SIX  SECONDS 

BEFORE  ANOTHER  CONVERSION  IS  PERFORMED 


THERMOMETER  VARIABLE  DEFINITIONS 
MEMORY  SYSTEM  CONSTANTS 
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BEGIN 
LASTM 


EQU 
EQU 


50H 
1000H 


:l/0  UNITS  AND  PIO  ADDRESSES 


PIODRA 

EQU 

OEOH 

PIOCRA 

EQU 

0E2H 

PIODRB 

EQU 

0E1H 

PIOCRB 

EQU 

0E3H 

;DEFINITIONS 

LEDON 

EQU 

4 

LEDSL 

EQU 

5 

MSCNT 

EQU 

0F9H 

STCON 

EQU 

lOOOOOOOB 

TPULS 

EQU 

2 

TSAMP 

EQU 

1500 

;STARTING  ADDRESS  OF  MAIN  PROGRAM 
;STARTING  ADDRESS  FOR  RAM  STACK 


:INPUT  PIO  FOR  CONVERTER 
;OUTPUT  PIO  FOR  DISPLAYS 


BIT  POSITION  TO  SEND  DATA  TO  LEDS 
BIT  POSITION  TO  SELECT  LEADING  DISPLAY 
COUNT  NEEDED  TO  GIVE  1  MS  DELAY 
OUTPUT  TO  BRING  START  CONVERSION  HIGH 
DISPLAY  PULSE  LENGTH  IN  MS 
TSAMP  IS  THE  NUMBER, OF  TIMES  THE 
DISPLAYS  ARE  PULSED  IN  A 
TEMPERATURE  SAMPLING  PERIOD.  THE 
LENGTH  OF  A  SAMPLING  PERIOD  IS  THUS 
2*TPULS'TSAMP  MILLISECONDS.THE  FACTOR 
OF  2'TPULS  IS  INTRODUCED  BY  THE  FACT 
THAT  EACH  OF  2  DISPLAYS  IS  PULSED  FOR 
TPULS  MS 


ORG  0 

;RESET  ROUTINE  TO  REACH  THERMOMETER  PROGRAM 

JP  BEGIN  ;FIND  THERMOMETER  PROGRAM 

INITIALIZATION  OF  THERMOMETER  PROGRAM 


ORG 

LD 

OUT 

LD 

OUT 

LD 


BEGIN 

A.01001111B 

(PIOCRAi.A 

A.00001111B 

{PIOCRB),A 

SP.LASTM 


iPULSE  START  CONVERSION  LINE 


START; 


LD 
OUT 
SUB 
OUT 


A.STCON 

(PIODRB),A 

A 

(PIODRB),A 


:MAKE  PIO  PORT  A  INPUT 
:MAKE  PIO  PORT  B  OUTPUT 
:PUT  STACK  AT  END  OF  RAM 

:SEND  START  CONVERSION  HIGH 
;SEND  START  CONVERSION  LOW 
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:DELAY  1  MS  FOR  CONVERSION 

LD  A.I 
CALL  DELAY 


;CONVERSION  DELAY  TIME  I 
:WA1T  FOR  CONVERSION 


MS 


•.READ  DIGITAL  DATA  FROM  CONVERTER 

IN  A,{PIODRA)         :GET  DATA  FROM  A/D  CONVERTER 

;CONVERT  A/D  DATA  TO  2  BCD  DIGITS 

CALL       CONVR  :CONVERT  DATA  TO  BCD 


;GET  LEAST  SIGNIFICANT  DIGIT 


LD 
AND 
SET 
LD 


B.A 
OFH 

LEDON.A 
E.A 


SAVE  BCD  DIGITS 
MASK  OFF  LSD 
SET  OUTPUT  TO  LEDS 
SAVE  LSD  IN  REGISTER  E 


GET  MOST  SIGNIFICANT  DIGIT,  BLANK  LEADING  ZERO 


;  RESTORE  BCD  DIGITS 
;SHIFT  MSD 


LD 

A.B 

RRCA 

RRCA 

RRCA 

RRCA 

AND 

OFH 

JR 

Z.SVMSD 

SET 

LEDON.A 

SET 

LEDSL.A 

LD 

D.A 

SVMSD: 


:PULSE  THE  LED  DISPLAYS 


MASK  OFF  MSD 

DON'T  TURN  DISPLAY  ON  IF  VALUE  ZERO 
SET  OUTPUT  TO  LEDS 
SELECT  LEADING  DISPLAY 
SAVE  MSD  IN  REGISTER  D 


DSPLY; 


LD 

C.PIODRB 

:GET  OUTPUT  PORT  ADDRESS 

LD 

HL.TSAMP 

:GET  16-BIT  PULSE  COUNTER 

OUT 

!C),D 

;OUTPUT  LEADING  DIGIT  TO  DISPLAY 

LD 

A.TPULS 

;DELAY  DISPLAY  PULSE  LENGTH 

CALL 

DELAY 

OUT 

!C).E 

;OUTPUT  TRAILING  DIGIT  TO  DISPLAY 

LD 

A.TPULS 

:  DELAY  DISPLAY  PULSE  LENGTH 

CALL 

DELAY 

DEC 

HL 

;  COUNT  DOWN  16-BIT  COUNTER 

LD 

A.H 

:  REMEMBER  DEC  HL  DOES  NOT  SET  Z  FLAG 

OR 

L 

JR 

NZ.DSPLY 

iCONTINUE  PULSING  DISPLAYS 

JP 

START 

;G0  SAMPLE  TEMPERATURE  AGAIN 

:SUBROUTINE  DELAY  WAITS  FOR  THE  NUMBER  OF  MILLISECONDS  SPECIFIED 
;    IN  REGISTER  A 
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DELAY: 

EXX 

:SAVE  USER  REGISTERS 

DLY1; 

LD 

C.MSCNT 

•.LOAD  REGISTER  C  FOR  1  MS  DELAY 

WTLP; 

DEC 

C 

:WAIT  1  MS 

JR 

NZ.WTLP 

DEC 

A 

:COUNT  DOWN  NUMBER  OF  MS 

JR 

NZ.DLY1 

EXX 

:  RESTORE  USER  REGISTERS 

RET 

;SUBROUTINE  CONVR  CONVERTS  INPUT  FROM  A/D  CONVERTER  TO  DEGREES 
;    CELSIUS  BY  USING  A  TABLE.  INPUT  DATA  IS  IN  THE  ACCUMULATOR. 
:    RESULT  IS  2  BCD  DIGITS  IN  THE  ACCUMULATOR 

:REGISTERS  USED:  A.B.C.H.L 


CONVR: 


LD 

HL.DEGTB 

GET  BASE  ADDRESS  OF  CONVERSION 
TABLE 

LD 

B.A 

SAVE  A/D  INPUT 

LD 

CO 

START  DEGREES  AT  ZERO 

LD 

A.!HU 

GET  ENTRY  FROM  TABLE 

CP 

B 

IS  A/D  INPUT  BELOW  ENTRY? 

LD 

A.C 

GET  VALUE  IN  DEGREES  CELSIUS 

RET 

NC 

YES.  VALUE  FOUND 

ADD 

A.I 

NO,  ADD  1  TO  DEGREES 

DAA 

KEEP  DEGREES  IN  BCD 

LD 

C.A 

INC 

HL 

JR 

CHVAL 

:TABLE  DEGTB  WAS  OBTAINED  BY  CALIBRATION  WITH  A  KNOWN  REFERENCE 
:DEGTB  CONTAINS  THE  LARGEST  INPUT  VALUE  THAT  CORRESPONDS  TO  A 
;    PARTICULAR  TEMPERATURE  READING  (I.E..  THE  FIRST  ENTRY  IS  DECIMAL 
;    58  SO  AN  INPUT  VALUE  OF  58  IS  THE  LARGEST  VALUE  GIVING  A  ZERO 
:    TEMPERATURE  READING  -  VALUES  BELOW  ZERO  ARE  DISPLAYED  AS  ZERO 
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DFGTB-  DEFB 

58 

DEFB 

61 

DEFB 

63 

DEFB 

66 

DEFB 

69 

DEFB 

71 

DEFB 

74 

DEFB 

77 

DEFB 

80 

DEFB 

84 

DEFB 

87 

DEFB 

90 

DEFB 

93 

DEFB 

97 

DEFB 

101 

DEFB 

104 

DEFB 

108 

DEFB 

112 

DEFB 

116 

DEFB 

120 

DEFB 

124 

DEFB 

128 

DEFB 

132 

DEFB 

136 

DEFB 

141 

DEFB 

145 

DEFB 

149 

DEFB 

154 

DEFB 

158 

DEFB 

163 

DEFB 

167 

DEFB 

172 

DEFB 

177 

DEFB 

181 

DEFB 

186 

DEFB 

191 

DEFB 

200 

DEFB 

204 

DEFB 

209 

DEFB 

214 

DEFB 

218 

DEFB 

223 

DEFB 

227 

DEFB 

232 

DEFB 

236 

DEFB 

241 

DEFB 

245 

DEFB 

249 

DEFB 

253 

DEFB 

255 

END 
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Index  of  Instruction  Descriptions 


ADC  A.data  3-43 
ADC  A.reg  3-44 
ADC  A.IHL)  3-45 
ADC  A.dX  +  disp)  3-45 
ADC  A,(IY  +  displ  3-45 
ADC  HL.rp  3-46 
ADD  A.data  3-47 
ADD  A.reg  3-48 
ADD  A,1HU  3-49 
ADD  A.IIX  +  disp)  3-49 
ADD  A.(IY  +  disp)  3-49 
ADD  HLrp  3-50 
ADD  xv.rp  3-51 
AND  data  3-52 
AND  reg  3-53 
AND  (HL)  3-54 
AND  (IX  +  disp)  3-54 
AND  liY  -I-  disp)  3-54 

BIT  b.reg  3-55 
BIT  b,(HU  3-56 

BIT  b.dX  -I-  disp)  3-56 

BIT  b,(IY  +  displ  3-56 

CALL  label  3-57 

CALL  condition.label  3-58 

CCF  3-59 

CP  data  3-60 

CP  reg  3-61 

CP  (HL)  3-62 

CP  (IX  -I-  disp)  3-62 

CP  (lY  +  disp)  3-62 

CPD  3-63 

CPDR  3-64 

CP)  3-65 

CPIR  3-66 

CPL  3-67 

DAA  3-68 
DEC  reg  3-69 
DEC  rp  3-70 
DEC  IX  3-70 
DEC  lY 

DEC  (HL)  3-71 

DEC  (IX  -t-  disp)  3-71 

DEC  (lY  -t-  disp)  3-71 

Dl  3-72 

DJNZ  disp  3-73 

El  3-73 
EX  AF.AF  3-75 
EX  DE.HL  3-76 
EX  (SP).HL  3-77 
EX  (SP),IX  3-77 
EX  (SP),IY  3-77 
EXX  3-78 

HALT  3-79 


IM  0  3-80 

IM  1  3-80 

\M  2  3-80 

IN  A,(port)  3-81 

INC  reg  3-82 

INC  rp  3-83 

INC  IX  3-83 

INC  lY  3-83 

INC  (HL)  3-84 

INC  (IX  +  disp)  3-84 

INC  (lY  -I-  disp)  3-84 

IND  3-85 

INDR  3-85 

INI  3-86 

INIR  3-86 

IN  reg,(C)  3-87 

JP  label  3-88 

JP  condition.label  3-89 

JP  (HL)  3-90 

JP  (IX)  3-90 

JP  (lY)  3-90 

JR  C.disp  3-91 

JR  disp  3-92 

JR  NCdisp  3-93 

JR  NZ.disp  3-93 

JR  Z.disp  3-94 

LD  A.l  3-94 

LD  A,R  3-94 

LD  A,(addr)  3-95 

LD  A,(rp)  3-96 

LD  dst.src  3-97 

LD  HL.(addr)  3-98 

LD  rp,(addr)  3-98 

LD  IX,(addr)  3-98 

LD  IY,(addr)  3-98 

LD  I.A  3-99 

LD  R.A  3-99 

LD  reg.data  3-100 

LD  rp.data  3-101 

LD  IX.data  3-101 

LD  lY.data  3-101 

LD  reg.(HU  3-102 

LD  reg.dX  +  disp)  3-102 

LD  reg.dY  +  disp)  3-102 

LD  SP.HL  3-103 

LDSP.IX  3-103 

LD  SP.IY  3-103 

LD  (addr).A  3-104 

LD  (addr).HL  3-105 

LD  (addr).rp  3-105 

LD  (addr).xv  3-105 

LD  (HU.data  3-107 

LD  (IX  +  disp).data  3-107 

LD  (lY  +  dispj.data  3-107 
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Index  of  Instruction  Descriptions  (Continued) 


LD  (HU.reg  3-108 

LD  (IX  +  disp).reg  3-108 

LD  (lY -I- displ.reg  3-108 

LD  (rp).A  3-109 

LDD  3-nO 

LDDR    3-1 1 1 

LDI  3-112 

LDIR  3-113 

NEG  3-113 
NOP  3-114 

OR  data  3-115 

OR  reg  3-116 

OR  (HU  3-117 

OR  (IX  +  disp)  3-117 

OR  (lY -I- disp)  3-117 

OUT  (C). reg  3-118 

OUTD  3-119 

OTDR  3-119 

OUTI  3-120 

OTIR  3-120 

OUT  (portKA  3-121 

POPrp  3-122 
POP  IX  3-122 
POP  lY  3-122 
PUSH  rp  3-123 
PUSH  IX  3-123 
PUSH  I Y  3-123 

RES  b.reg  3-124 

RES  B.(HL)  3-125 

RES  b.dX  4- displ  3-125 

RES  b.ilY -I- disp)  3-125 

RET  3-126 

RETcond  3-127 

RETI  3-128 

RETN  3-129 

RL  reg  3-130 

RL(HU  3-131 

RL  (IX -«- disp)  3-131 

RL  (lY -f  disp)  3-131 

RLA  3-132 

RLC  reg  3-133 

RLC  (HU  3-133 

RLC  (IX  4- disp)  3-134 

RLC  (lY -^  disp)  3-134 

RLC  A  3-135 


RLD  3-136 

RR  reg  3-137 

RR  (HL)  3-138 

RR  (IX  +  disp)  3-138 

RR  (lY  +  disp)  3-138 

RRA  3-139 

RRC  reg  3-140 

RRC  (HL)  3-141 

RRC  (IX  +  disp)  3-141 

RRC  (lY disp)  3-141 

RRC  A  3-142 

RRD  3-143 

RSTn  3-144 

SBC  A.data  3-145 

SBC  A.reg  3-146 

SBC  A,(HL)  3-147 

SBC  A,(IX  +  disp!  3-147 

SBC  A,(IY  4-  disp!  3-147 

SBC  HLrp  3-148 

SCF  3-149 

SET  b.reg  3-150 

SETb,(HLl  3-151 

SET  b,(IX -t- disp)  3-151 

SET  b,(IY -I- disp!  3-151 

SLA  reg  3-152 

SLA  (HL)  3-153 

SLA  (IX -F  disp)  3-153 

SLA  (lY  4- disp)  3-153 

SRA  reg  3-154 

SRA  (HL)  3-155 

SRA  (IX  4- disp)  3-155 

SRA  (lY  4- disp)  3-155 

SRL  reg  3-156 

SRL  (ML!  3-157 

SRL  (IX  4-  disp)-  3-157 

SRL  (lY  4- disp!  3-157 

SUB  data  3-158 

SUB  reg  3-159 

SUB  (HL!  3-160 

SUB  (IX  4- disp)  3-160 

SUB  (lY  4-  disp)  3-160 

XORdata  3-161 
XOR  reg  3-162 
XOR  (HL)  3-163 
XOR  (IX  4-  disp)  3-163 
XOR  (I Y  4- disp)  3-163 
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Index 


Accumulator,  using  the.  4-2 
Add/Subtract  flag,  8-7 

-Address  field,  numbers  and  characters  in.  3-172 

Algebraic  notation.  1-8 

Algorithm 

multiplication.  8-8 

simple  sorting.  9-10 
Allocating  RAM.  2-7 

Anthmetic  and  Logical  Expressions,  2-10 
ASCII 

characters.  2-10 

handling  data  in,  6-1 
Assembler,  1-5 

arithmetic  and  logical  operations,  3-172 

choosing  an.  1-6 

meta-.  2-14 

micro-,  2-14 

one-pass.  2-14 

resident,  2-14 

two-pass,  2-14 
Assembler  directive,  2-4 
Assembly  language 

applications,  1-10 

fields,  2-1 

program.  1-5 

Basic  software  delay.  11-8 
BCD  and  binary,  accuracy  in.  8-8 
Blanking  a  leading  zero.  16-22 
Block  I/O  instruction,  6-6 

use  of.  11-21 
Block,  moving  data  within,  7-8 
Block  search  instructions.  6-6 
Block  transfer  instructions,  8-4 
Binary  and  BCD,  accuracy  in.  8-8 
Binary  instructions.  1-1 

rounding.  8-24 
Binary  numbers,  doubling  and  halving.  8-23 
Bootstrap  loader.  2-15 
Bottom-up  design.  13-44 
Breakpoint,  14-2 

insertion  of,  14-3 

RST  as,  14-2 
Buffer 

double  buffering.  12-7 

emptying  with  interrupts.  12-19 

filling  via  interrupts,  12-16 
Buffer,  emptying  with  interrupts,  12-19 

Calibration  table,  use  of,  16-21 
Character  format.  1 1-81 
Checklist,  what  to  include  in,  14-10 
Coding.  13-3 

relative  importance  of.  13-1 
Commenting 

examples.  15-4 

guidelines,  15-2 

techniques,  2-13 


questions  for.  15-4 
Common-anode  or  common-cathode  displays. 

11-  43 
Compiler.  1-7 

cost  of.  1-8 
Computer  program,  1-1 
COND  and  ENDC  pseudo-operations,  3-174 
Control  and  status  information.  11-57 
Control  information,  combining.  11-58 
Credit  verification  terminal,  structural  program 

for.  13-38 
Cross-assembler.  2-14 

Daisy  chain 
device  operation  in,  12-10 
interrupts,  advantages  and  disadvantages, 

12-  9 

PIO  interrupts.  12-9 
Data,  forming  classes  of.  14-28 

moving  within  a  block.  7-8 
Data  flowcharts.  13-19 
Debouncing 

m  software.  1 1-26 

with  cross-coupled  NAND  gates.  11-28 
Debugging.  13-3 

code  conversion  program.  14-6 

interrupt-driven  programs.  14-14 

sort  program.  14-6 

use  of  test  cases  from.  14-27 
Decimal 

accuracy  in  binary,  8-4 

adjust,  8-7 

data  or  addresses,  2-9 

rounding,  8-24 

shift  instructions,  8-21 
DEFB,  DEFL,  DEFM,  DEFS.  DEFW  pseudo- 

opera|tions.  3-170,  3-171 
Definition  list 

rules  for,  15-8 

typical.  15-9 
Definitions,  placement  of.  2-7 
Delay  loop  constant,  11-10 
Delimiters,  2-2 

Direct  memory  access  (DMA),  1 1-5 
Disabling  interrupts.  12-25 
Displays,  common-anode  or  common-cathode. 
11-43 

Division  algorithm.  8-12 
Documentation.  13-3 

of  status  and  control  transfer.  1 1-59 

of  subroutines,  10-2 

package.  15-13 
Double  buffering,  12-7 

8-bit  summation.  5-3 
8080A  unused  operation  codes,  3-164 
8080A/Z80 
assembly  level  conversion,  3-164 
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Index  (Continued) 


8080A/Z80  (continued) 

compatibility  features,  3-164 

incompatibilities,  3-164 
8085/Z80  incompatibilities,  3-165 
ENDC  and  COND  pseudo-operations,  3-174 
Error  considerations,  13-5 
Errors,  common,  14-11 
Example  format,  4-1 
Examples,  guidelines  for,  4-1 
Execution  time,  saving,  15-15 
External  references,  2-8 

Flowcfiarting 
advantages  of,  13-17 
credit  verification,  13-22 
disadvantages  of,  13-18 
sections,  13-22 
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